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The Assembly Line 

The CoO 
Goes Buggy 

by William P. Nee * 



^^^^ ometimes when I m shovel - 
^^^^^ ing snow or hauling firewood 
• ^B down to the basement, I re- 
^^^^ member those carefree halcyon 
days of summer in Florida. I remember 
sitting outside in the evening, sipping a 
soft drink and — you guessed it - 
swatting bugs! A little after sun- 
down, the evening ritual would 
begin; out would come the swarms 
of insects and out would come the elec- 
tric bug zappers. Great swarms of bugs 
would swirl, enticed by the pale light, and 
slowly revolve into it; each bug was 
further attracted by the faint flicker of 
a neighbor who had bumped into the 
electric coils. 

To recapture this image, I decided to 
simulate it using the Color Computer. With 
Bugs, a large swarm of bugs appears on the 
screen. At first each bug moves in arandom 
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— and they swirl 
Slowly the swarm gets 
until one lone bug 
dances his way across 
the screen to his ulti- 
mate fate. Of course it takes a ma- 
chine-language program to simulate 
all the motion and to rapidly com- 
pute the changes in direction 
for the swarm. 

The assembly-language 
program shown in Listing 2 does 
all of this for us. The program starts with 
a RANDOM macro (adapted from 
• >, my PUCHINKO program in the 
•y\ Rainbow, July 1991, Page 31) 
«5>* thai assigns a random +1 or -1 
change of direction to each bug. 
There are two 500-byte arrays that store all 
the necessary bug information. The LOC 
array stores the current x and y coordi- 
nates for each bug, and DEL holds the 
changes in direction for these co- 
ordinates. A bug's new location 
is its current location plus its cur- 
rent change in direction (no more 
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than +1 or - 1 ). Since each array is 500 
bytes in length, there can be no more 
than 250 hugs. 

After equating =SET, P POINT and 
RND ( ) to their actual ROM locations, NUMB 
holds ihe number of bugs, and LEM is the 
horizontal line with the imaginary bug zap- 
per. The RANLOC routine picks random co- 
ordinates on the screen and checks to see if 
that point is already occupied (using 
P PO I NT). If not, the coordinates are saved in 
the LOC array and that point is set (using) 
PSET. Next, the RANDOM macro assigns an 
initial change of direction of +1 or -1 to 
each x and y coordinate and stores the points 
in the DEL array. 

Since most insects fly in a straight line 
for short distances, I've included a variable 
I refer to as NumberOf Times. This counter 
(C0UNT1) reflects how many times a bug 
may move in the same direction before new 
random changes are computed. I use a value 
of five, but you can make this as low as one, 
or higher if you want. Next, the current * 
and y coordinates are taken from the LOC 
array and that point is PRESET. Then the 
changes in the DEL array (500 bytes away) 
are added to the current coordinates. The 
program checks the y coordinate to keep it 
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.ike many CoCo 3 users, I wondered 
whether or not I should move to one of the 
OS-9/68000-based computers now avail- 
able in this market. Having been a CoCo 
user since the days of the original Color 
Computer. I remember having only 4K of 
memory and using the original Color BA- 
SIC. From there I progressed to a 64K, OS- 
9 Level I system. And when the CoCo 3 
came along, 1 bought one and soon found 
myself upgrading it to 512K of memory and 
adding OS-9 Level II and a hard drive. 

When discussion of the so-called CoCo 
4 machines started several years ago, I 
wrote to the three companies involved (EMS, 



FHL and Delmar) asking for all the infor- 
mation available. About the same time 1 
joined a local Unix users group and gained 
access to USENET/INTERNET. Here I 
was able to ask others about using OS-9 on 
68000-based computers. After getting all 
the facts and opinions I could, I decided to 
"move" to one of the new computers. I 
selected the MM/1 from Interactive Media 
Systems. In this article I share some of my 
experiences with OSK and the MM/1, and 
point out some differences between OSK 
and OS-9/6809. 

SEEGSKONPAGE16 
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Needs Help With Scripsit 
Editor: 

I've been a subscriber to THE rainbow 
since February of this year. I bought my 
CoCo 3 primarily to see what I could learn 
to do with it, and the original Extended 
BASIC Manual has guided me most of the 
way. I'm very much a computer green- 
horn, but I can see why CoCo fans like THE 
RAINBOW. I have a few questions for which 
I'd like answers. 

Occasionally, when using Scripsit (Cat. 
No. 26-3105), the computer suddenly starts 
acting like the SHIFT key is being held 
down — it prints only capital letters. The 
only way I've found to slop this is to first 
save on tape whatever is in memory, then 
turn the CoCo off. When I turn it back on, 
I can reload from the tape and everything is 
back to normal. 

Once while 1 was using BASIC, the CoCo 
began printing only lowercase characters 
on the screen. It would print capitals only 
when I used the SHIFT key. As before, I 
could return the computer to normal only 
by turning the CoCo off. What did I do 
wrong and can 1 correct it without having to 
turn the CoCo off? 

Occasionally when loading files from 
tape, Scripsit will stop somewhere in the 
middle of the program and flash an error 
message on the screen. It might stop even in 
the middle of a word. 1 suspect a flaw in the 
tape, but is there any way I can make it 
resume loading the remaining part of the 
file? 

Although the example for right justifica- 
tion in the DMP-107 manual (Page 35) 
works, how do I adapt it to work with a 
whole paragraph or more? Also, although 
both command examples work for printing 
bold and normal letters in the same line 
(Page 99) and italicized and non-italicized 
in the same line (Page 1 00), how do I tell the 
printer to print only specific words in a 
paragraph or sentence in bold or italics? 

Is there any way to direct a BASIC com- 
mand to the printer while I'm using Scrip- 
sit! And is there any way to load a program 
into Scripsit from tape that was CSAVED 
from within BASIC? 

Is it true that all computers use the 
Microsoft BASIC language, except perhaps 
for the Atari and Commodore? 

R.L. Aldrich 

2505 Bernard 

Denton, TX 76205 

We suspect your problem with upper- 
and lowercase characters has to do with the 
SHIFT-Lock function of the CoCo keyboard. 
When you first turn on the CoCo, it is in the 
all-uppercase mode. You can switch to 
lowercase by holding down the SHIFT key 
and pressing (zero). Pressing SHIFT -0 
again returns you to the uppercase mode. 
When you start Scripsit, it comes up in the 
lowercase mode. SH1FT-0 can be used to 
toggle in and out of the all-caps mode. 
Perhaps you were trying to enter a right 
parenthesis or asterisk and, while holding 
down SHIFT, pressed theO key by accident. 
If the problem occurs again, just try press- 
ing SHIFT-0. 



Chances are, the error message you 
sometimes receive when loading files into 
Scripsit is telling you there is a media error 
— a dropout or a bad spot on the tape. While 
you can't resume a stopped load, you can 
rewind and try again after adjusting the 
volume a little on the tape recorder. 

The BASIC interpretersfor many personal 
computers were indeed written by Micro- 
soft. This makes switching from one system 
to another a little easier. However, various 
personal computers offer different features, 
and Microsoft wrote these interpreters sepa- 
rately. Some commands available on a spe- 
cific computer might not be available on 
others. 

Hint for V/P/basic Editing 
Editor: 

I use VIP Writer III for editing BASIC 
programs, and I keep an ASCII copy of the 
program file on my VIP disk and a binary 
copy on my work disk. During a recent 
session, I loaded the ASCII copy of a pro- 
gram, made a few changes, then resaved it to 
my VIP disk. I then updated the copy on my 
work disk by saving the ASCII copy on top 
of the old binary copy. 

However, when I attempted to run the 
program on my work disk. I received errors. 
Listing the program to ihe screen revealed 
that it had become garbled. It loaded into 
VIP just fine but was garbled whenever I 
tried to load it from BASIC. 

When I checked Ihe directory Irack, I 
discovered thai VIP had not changed the 
file-type byte to reflect the fact that thecopy 
on my work disk was an ASCII file. The 
BASIC interpreter was attempting to read 
tokens out of the ASCII text. 

Therefore, when editing basic programs 

with VIP, you should never save an ASCII 

copy of a file on top of a binary copy. To 

avoid problems, save the ASCII copy with a 

different extension (such as . ASC) instead. 

Trevor Boehm 

77 Inwood Cres. 

Winnipeg, MB R2Y 1A2 

Canada 

MIDI, MIDI Questions 

Editor: 

What does a MIDI keyboard do, and how 
do you hook it up to a CoCo? How does it 
enhance the sound capabilities of the CoCo 
(if that's what it does)? Which keyboard 
would you recommend in the $200-to-$300 
price range. 

Owen Crabtree 

21 1 SW 6th Street 

College Place, WA 99324 

MIDI stands for Musical Instrument 
Digital Interface and is a standard that 
simplifies the interconnection of electronic 
musical instruments, as well as their use 
with computers. Most CoCo MIDI software 
is designed to send data to MIDI instru- 
ments though the rear serial port. Some 
products also support a special hardware 
puck once available from Speech Systems 
(perhaps Rulaford Research has a few). 
MIDI doesn't enhance the sound capabili- 
ties of the CoCo; rather, it expands these 
capabilities using external hardware such 
as keyboards and drum machines. Manag- 
ing editor Cray Augsburg has the Yamaha 
PSS-680 and also likes the Casio MT-540 
and MT-240, though these units are not 
currently available new — check the bar- 
gain papers for used units. For more infor- 
mation about MIDI, see "Play It Again, 
CoCo" (December 1989, Page 74). 

Kudos to Coless 

Editor: 

I have a few good words to say about Mr. 
Walter Bayer and Coless Computer Design. 



I recently purchased CI II PagesE 25. Prior 
to my purchase, however, I wrote to Mr. 
Bayer with my concerns about printer 
support. I have a 512K CoCo 3, an RGB 
monitor and a DMP-130A printer, which 
according to the catalog isn't supported by 
CIII PagesE. 

Not only did Mr. Bayer write back, he 
included a disk and a solution to the prob- 
lem. Since then we have talked on the 
phone on a number of occasions, and Mr. 
Bayer has always been very helpful. 

If you have a Tandy DMP-series printer 
and are looking for a good desktop pub- 
lisher, give CIII PagesE a try. The product 
and the service is as advertised. 

By the way, thank you for publishing an 
answer to my question in the August 1992 
edition of "OS-9 Hotline." Il was very 
helpful. 

Ernest Baziinotti, Jr. 

91 Huggins Road 

Rockland, MA 02370 

Wants to Market BASIC Programs 

Editor: 

The first issue of THE RAINBOW I re- 
ceived was your last "glossy" issue. Al- 
though I liked that format better, I love THE 
RAINBOW anyway. I have written many 
BASIC programs thai I would like to sell, 
but I can't afford to copyright and market 
them. Do you know of any companies that 
would buy them from me or pay royalties 
lor them? What do you suggest? 

Where can I get a Y-cable that I can use 
to connect my disk controller and modem 
(or Speech/Sound Cartridge) to my CoCo 
at the same time? And where can I get 
CoCo Max III? 1 have heard a lot about it 
but have never seen it advertised. 

Is the OS-9 shell at the beginning of 
games like Rogue, Microscopic Mission 
and Zone Runner enough to run other 
programs that indicate "Requires OS-9 
Level II?" 

Lei f Olson 

238 4th NW 

P.O. Box 124 

Tioga, ND 58852 

You can contact advertisers in THE RAIN- 
BOW to inquire about marketing your soft- 
ware through them. Better yet, send your 
programs to us — we're always interested 
in programs for publication. 

We know of no company currently of- 
fering a Y cable. However, THE RAINBOW 
columnist Marty "The King of Kables" 
Goodman may be able to help. We have 
forwarded a copy of your letter to him. 

For the most part, the OS-9 shell in- 
cluded with the games you mention is 
complete, and some third-party OS-9 of- 
ferings may work fine with it. However, 
this shell is minimal and doesn't include 
many of the utilities you really need to 
work with OS-9. There are several files in 
the OS9 Online databases on Delphi de- 
scribing how to use these limited shells. 
OS-9 is available through Tandy's Ex- 
press Order (call I -800-32 1 -3 1 33). 

Wants Program Paks 

Editor: 

I am writing to find out if you carry 
Program Paks forthe Color Computer 2? If 
so, do you have a catalog of the games, and 
will you please send me a copy? I would 
also like to know the address for Radio 
Shack in Fort Worth. 

David Basonic 
804 East 18th Street 
Cameron, TX 76520 

No, we don't actually sell Program 
Paks, nor do we know of any CoCo vendors 
currently offering them commercially. Per- 
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haps other readers would part with theirs. 
Barring this, try Tandy's Express Order 
system at (800) 321-3133. You can write to 
Tandy/Radio Shack at One Tandy Center, 
Fort Worth, TX 76102. 

High-Speed Disk Blues 

Editor: 

I am having trouble loading files on one 
of my disks. I was writing a program that 
runs in the high-speed mode and forgot to 
slow down the computer before I saved it. 
When I type D I R, I get an I/O error. I also get 
an I/O error whenever I try to use Basic's 
D S K I $ command to see what the problem is. 
Do you know of any programming tech- 
niques with BASIC or BASIC09 that I can use 
to salvage the files on the disk? Where can 
I find programs that would remedy my 
situation? 

Is there any way to alter the output of the 
RF port on a Commodore 64 so that it can 
be connected to an RGB monitor? If so, I 
would like to know how, no matter how 
complex the procedure might be. Please 
don't refer me to a past issue of THE rain- 
bow — I don't have access to any of them. 
I would also like a ballpark figure on how 
much the parts will cost. 

Also, I am interesting in finding a work- 
ing 5 1 2K memory upgrade, a 1 -meg mem- 
ory upgrade, an FD-502 disk drive and 
working Color Computers ( 1 , 2 or 3). I will 
try to answer all letters. 

Brandon Broyles 

4901 Wheeler Drive 

The Colony, TX 75056 

We fear your data is forever garbled. 
Once a file is saved at high speed, there is 
little chance of recovering it. For future 
reference. Steve Bjork wrote a utility called 



OF I X and uploaded it to the CoCo S1G on 
Delphi back when the CoCo 3 was first 
introduced. This machine-language rou- 
tine allows high-speed disk access in most 
cases. 

We have forwarded a copy of your letter 
to Marty "Monarch of Monitors" Goodman. 
Perhaps he can help you with your C64-W- 
RGB question. 

A Bigger Binder for THE rainbow 

Editor: 




DRREO 
— TI0NS 


After reading "Print #-2" in the July 
1992 issue, I decided to share the method I 
use to store THE RAINBOW. Radio Shack at 
one time carried (and can currently order) a 
14 7 /s-by-ll printout binder (Cat. No. 26- 
211). If you punch two holes in the left 
margin of THE RAINBOW, the magazine fits 
in the binder just fine. And one binder hold s 
30 to 40 issues in the new format. Thank 
you for keeping THE RAINBOW alive! 

Gary Erxleben 

110 State Street 

N. Pekin, 1L 61554 


"PowerBoost: Speeding Up the CoCo" 
(Review, September 1992, Page 1): Need- 
less to say, we are pretty excited that the 
6309 from Hitachi works with the CoCo 3. 
Our enthusiasm, however, resulted in our 
misinterpreting part of Marty Goodman's 
review of Burke & Burke's PowerBoost. 
Contrary to what we reported, Burke & 
Burke is not at this time selling the 6309 
microprocessor as a separate unit. It is, 
however, available as an optional part of 
PowerBoost. We apologize for any incon- 
venience our error may have caused. 

"Sort Directories With BASIC09" (Oc- 
tober 1992, Page 4): Author Ken Kobes 
contacted us to report a bug in SortDir. This 
error expands the directory file being sorted 
by one byte so that its length is no longer a 
multiple of 32. This creates a problem when 
OS-9 later expands the directory file to 
make room for new entries. To fix the bug, 
make the following corrections to 
SortDir. b09: 

At Offset OOCF, change DIM zero:BYTE 
to DIM zero:STRING[32], and at Offset 
00D6, change zero :=$ 00 to zero:=CHR$(0). 


THE rainbow welcomes letters to the 
editor. Mail should be addressed to: Letters 
to Rainbow, The Falsoft Building. 9509 
U.S. Hwy 42, P.O. Box 385, Prospect, KY 
40059. Letters should include the writer's 
full name and address. Letters may be ed- 
ited for clarity or to conserve space. 

Letters to the editor may also be sent to 
us through our Delphi CoCo SIG. From the 
CoCo SIG> prompt, enter RA I to get to the 
Rainbow Magazine Services area of the 
SIG. At the RAINBOW> prompt, enter LET 
to reach the LETTERS> prompt, then se- 
lect Letters for Publication. Be sure to in- 
clude your complete name and address. 
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It happens all the time. You 're 
in the middle of a document or 
spreadsheet, or perhaps a game or 
other BASIC program, when you are 
interrupted and have to leave your 
CoCo unattended. If you live alone, this is 
no problem. But, for those of us who have 
been blessed with siblings or offspring who 
like to get into things they don't yet under- 
stand, coming back to a blank screen can be 
a most frustrating experience. To prevent 
this problem, I wrote Password, an assem- 
bly-language program designed to stop other 
would-be users from compounding your 
interruptions. 

If you have an assembler (I used Disk 
EDTASM+), you can enter the source code 
in Listing 1 and assemble it. To execute the 
assembled program, you must enter 

CLEAR 1000,32340: L0ADM "PASSWORD 
.BIN":EXEC 32340 

This command line tells the CoCo that the 
highest address usable by BASIC is 32339, 
then loads and executes Password. 

If you don 't have an assembler or would 
prefer not to use one, enter the program 
shown in Listing 2 and save it to tape or 
disk. This program pokes the Password 




routine into the appropriate area 
of memory. Unlike other BASIC 
loaders, however, this program 
does not save the resultant 
machine-language program 
to tape or disk for you. In- 
stead, it goes ahead and exe- 
cutes the routine. 

The Password routine 
should be compatible with all 
BASIC programs and may also 
work with some machine-language 
software. To use it, just execute it when you 
turn your CoCo on, before running the 
other software you want to use. When you 
execute the program, you are instructed to 
enter a password of up to 10 characters. 
Password does not echo to the screen what 
you enter, so be careful when typing. 

After your password is safely tucked 
away. Password multitasks with BASIC, 
scanning the keyboard roll-over table 60 
times each second. To activate the routine, 
hold down the CTRL key and press L. A 
bell sounds to indicate Password is waiting 
for you to enter the correct pass word. To get 
back to what you were doing, simply type 
the password and press enter. Again, you 
will not be able to see what you are typing. 
If an incorrect password is entered, a long 
beep sounds, followed by another bell tone. 
If this happens, just try again — the process 
continues until the correct password is en- 
tered by the user. 

It is important to know that while Pass- 
word is active, everything is frozen. If the 




Bit CASSOUT 
Bit 1 RS-232C output 
Bit 2 6-Bit D/A 
Bit 3 6-Bit D/A 
Bit 4 6-Bit D/A 
Bit 5 6 Bit. D/A 
Bit 6 f>Bit D/A 
Bit 7 6-Bit D/A 

Figure 1: Part $FF20(PIA) 




disk drive was on, it will stay on until BASIC 
regains control. Even the basic TIMER 
function stops! This can be a handy feature, 
especially if you're playing a game that 
bases your score on your speed — just use 
CTRL-L as a game-pause function. 

Technical Considerations 

Unlike some other machine-language 
programs. Password won't cause your 
printer to print garbage when the program 
produces its sounds. It is very irresponsible 
of programmers who overlook this bug, 
causing users to be startled as their printers 
jump to life for no apparent reason. It's also 
a waste of paper. The explanation of this 
bug is somewhat technical, but I think the 
problem is worth some discussion. 

Memory Location SFF20 (65312 deci- 
mal) is the address which handles the 
CoCo's built-in 6-bit digital/analog con- 
verter. Among other things, this D/A con- 
verter is used to create sound. What many 
programmers don't realize is that this ad- 
dress also handles the CASSOUT line, 
which is used for cassette output (including 
controlling the Hi-Res joystick interface) 
and the RS-232C output line for the serial 
port. Figure 1 shows the bit assignments for 
Location $FF20. 



Submitting 
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To Rainbow 



Contributions to the rainbow 
are welcome from everyone. We 
like to run a variety of programs 
that are useful, helpful and fun 
for other CoCo owners. 

WHAT TO WRITE: We are 
interested in what you want to 
tell our readers. We accept for 
consideration anything that is 
well-written and has a practical 
application for the Tandy Color 
Computer. If it interests you, it 
will probably interest lots of oth- 
ers. However, we vastly prefer 
articles with accompanying pro- 
grams that can be entered and 
run. The more unique the idea, 
the more the appeal. We have a 
continuing need for short articles 
with short listings. These are es- 
pecially appealing to our many 
beginners. 

FORMAT: Program submis- 
sions must be on tape or disk, and 
it is best to make several saves, at 
least one of them in ASCII for- 
mat. We're sorry, but we do not 
have time to key in programs and 
debug our typing errors. All pro- 
grams should be supported by 
some editorial commentary ex- 
plaining how the program works. 
We also prefer that editorial copy 
be included in ASCII format on 
the tape or disk, using any of the 
word processors currently avail- 
able for the Color Computer. 
Also, please include a double- 
spaced printout of your editorial 
material and program listing. Do 
not send text in all capital letters; 
use upper- and lowercase. 

COMPENSATION: We do 
pay for submissions, based on a 
number of criteria. Those wish- 
ing remuneration should so state 
when making submissions. 

For the benefit of those want- 
ing more detailed information on 
making submissions, please send 
a sclf-addrcsscd, stamped enve- 
lope (SASE) to: Submission 
Guidelines, the rainbow. The Fal- 
soft Building, P.O. Box 385, Pros- 
pect, KY 40059. We will send 
you comprehensive guidelines. 

Please do not submit material 
currently submitted to another 
publication. 
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In most cases, programs don't tell the 
computer to write to a cassette or scan 
joystick positions while producing sound. 
So the CASSOUT line usually doesn't 
present a problem. But if a printer is plugged 
in and online during sound output, a couple 
of "garbage" bits in the D/A converter can 
quickly leave a lasting impression — on 
paper. 

Since you can always turn the printer 
off, this is a small price to pay to have high- 
quality sound on the CoCo. But the fact is, 
software is capable of filtering the garbage 
by using a single machine-language in- 
struction, which I use in lines 780 and 980 
of the assembly-language listing of Pass- 
word. The program uses Register B to store 
the value it's about to send to the D/A 
converter. The command ANDB #252 tells 
the CoCo to ensure that the first two bits of 
the value in Register B are not set (they are 
zeros). Using this technique, even digitized 
sound can be filtered without any notice- 
able decrease in speed. 

I urge all programmers to use filters in 
their sound routines. It does not affect the 



sound at all since the CASSOUT and RS- 
232C output lines are not connected to a 
speaker. Because sound filters are such an 
easy solution to an age-old CoCo problem, 
there is no excuse for not using them. 

As a final note. Password doesn't pro- 
tect against someone turning the CoCo off 
or pressing the Reset button. But it does 
keep the mildly nosy and unknowledgable 
from wreaking havoc while you are away 
from the computer. If you have any ques- 
tions or comments about Password, feel 
free to write to me. 



Joel Mathew Hegberg has been pro- 
gramming for nine years and enjoys writ- 
ing software for the Color Computer and 
MM/1. Some of his commercial creations 
are available through Sub-Etha Software. 
Joel can be contacted at 936 N. 12th Street, 
De Kalb, IL 60115-2516, (815) 748-6638. 
Please include an SASEwhen requesting a 
reply. 



Listing 1: PASSWORD 



00100 




ORG 


32340 


00110 




TITLE 


PASSWORD. ASM 


00120 








00130 






************************* 


00140 






♦"PASSWORD" WRITTEN FOR 


00150 






*THF RAINBOW MAGAZINE BY 


00160 






*J0EL MATHEW HEGBERG 


00170 






*936 NORTH TWELFTH STREET 


00180 






*DE KALB. ILLINOIS 60115 


00190 






*«***»*«***»*»***.******* 


00200 








00210 


BEGIN 


LBRA 


START 


00220 


DATA1 


FCC 


/ENTER YOUR PASSWORD./ 


00230 




FCB 


13 


00240 




FCB 





00250 


PASWRD 


RMB 


11 


00250 


BUFFER 


RMB 


11 


00270 


PRINT 


PSHS 


D.Y.U 


00280 


PRINT2 


LDA 


.X+ 


00290 




LBEQ 


PRTDON 


00300 




JSK 


[JA002] 


00310 




LBRA 


PRINT2 


00320 


PRTDON 


PULS 


D.Y.U 


00330 




RTS 




00340 


START 


LEAX 


DATA1.PCR 


00350 




IBSR 


PRINT 


00360 




LBSR 


GETBUF 


00370 




LEAX 


PASWRD, PCR 


00380 




LEAY 


BUFFER. PCR 


00390 




LDB 


#0 


00400 


LOO PI 


LDA 


,Y+ 


00410 




STA 


.X+ 


00420 




INCB 




00430 




CMPB 


#11 


00440 




LBLO 


L0OP1 


00450 




LDX 


269 


00460 




STX 


IROLOC.PCR 


00470 




LEAX 


IRQ. PCR 


00480 




STX 


269 


00490 




RTS 




00500 


1R0 


PSHS 


D.X.Y.U 


00510 




LDA 


342 


00520 




CMPA 


#189 


00530 




LBEQ 


FREE21 


00540 


IRQRTN 


PULS 


D.X.Y.U 


00550 




JMP 


[IROLOC.PCR] 


00560 


IR0I0C 


RMB 


? 


00570 


PATCH 


PSHS 


D.X.Y.U.CC 


00580 




ORCC 


#80 


00590 




LDA 


#189 


00600 




STA 


342 


00610 




LDD 


PRTLOC.PCR 


00620 




STD 


360 


00630 




PULS 


D.X.Y.U.CC 


00640 




JMP 


[360] 


00650 


SNDON 


LDA 


$FF01 


00660 




AN DA 


#247 


00670 




STA 


$FF01 


00680 




LDA 


$FF03 


00690 




ANDA 


#247 


00700 




STA 


$FF03 


00/10 




LDA 


$FF23 


00720 




ORA 


#8 


00730 




STA 


$FF23 


00740 




RTS 




00750 


T0NE1 


LBSR 


SNDON 


00760 




CLRB 




00770 


TNL0P1 


PSHS 


B 


00780 




ANDB 


#252 * SOUND FILTER 


00790 




STB 


$FF20 


00800 




PULS 


B 


00810 




C0M8 




00820 




LDY 


#80 


00830 


TNNXT1 


EXG 


D.Y 


00840 




SUED 


#1 


00850 




EXG 


D.Y 


00860 




CMPY 


#0 


00870 




LBNE 


TNNXT1 


00RR0 




CMPB 


#128 


00890 




LBHS 


TNL0P1 


00900 




INCB 




00910 




CMPB 


#128 


00920 




LBNE 


TNL0P1 


00930 




RTS 




00940 


T0NE2 


LBSR 


SNDON 


00950 




LDB 


#20 


00960 




LDX 


#200 


00970 


TNL0P2 


PSHS 


B 


00980 




ANDB 


#25? * SOUND FILTER 



00990 




STB 


$FF20 


01000 




PULS 


8 


01010 




COMB 




01020 




LDY 


#150 


01030 TNNXT2 


EXG 


D.Y 


01040 




SUBD 


#1 


01050 




EXG 


D.Y 


01060 




CMPY 


#0 


01070 




LBNE 


TNNXT2 


01080 




EXG 


D.X 


01090 




SUBD 


#1 


01100 




EXG 


D.X 


01110 




CMPX 


#0 


01120 




LBNE 


TNL0P2 


01130 




RTS 




01140 


PRTLOC 


RMB 


2 


01150 


FREEZ1 


LDD 


360 


01160 




STD 


PRTLOC.PCR 


01170 




LEAX 


PATCH, PCR 


01180 




STX 


360 


01190 


FREEZE 


LBSR 


T0NE1 


01200 




LBSR 


GETBUF 


01210 




LEAX 


BUFFER. PCR 


01220 




LEAY 


PASWRD. PCR 


01230 




LDB 


#11 


01240 


L00P2 


LDA 


.Y+ 


01250 




LBEQ 


PASS1 


01260 




CMPA 


.X+ 


01270 




LBNE 


NOPASS 


01280 




DECB 




01290 




LBEQ 


PASSOK 


01300 




LBRA 


L00P2 


01310 


NOPASS 


LBSR 


T0NE2 


01320 




LBRA 


FREEZE 


01330 


PASS1 


LDA 


.X 


01340 




LBNE 


NOPASS 


01350 


PASSOK 


LDD 


PRTLOC.PCR 


01360 




STD 


360 


01370 




LBRA 


IRQRTN 


01380 


GETBUF 


LDB 


#0 


01390 




LEAX 


BUFFER. PCR 


01400 


GETKEY 


JSR 


[SA000] 


01410 




LBEO 


GETKEY 


01420 




CMPA 


#8 


01430 




LBEQ 


BACKSP 


01440 




CMPA 


#13 


01450 




LBEQ 


ENTER 


01460 




CMPA 


#32 


01470 




LBLO 


GETKEY 


01480 




CMPA 


#127 


01490 




LBHI 


GETKEY 


01500 




CMPB 


#11 


01510 




L8HS 


GETKEY 


01520 




STA 


.X+ 


01530 




INCB 




01540 




LBRA 


GETKEY 


01560 


BACKSP 


CMPB 


#0 


01560 




LBEQ 


GETKEY 


01570 




LDA 


,-x 


01580 




DECB 




01590 




LBRA 


GETKEY 


01600 


ENTER 


CMPB 


#0 


01610 




LBEQ 


GETKEY 


01620 




CMPB 


#11 


01630 




LBEO 


C0NT1 


01640 




CLR 


.X+ 


01650 


CCNT1 


RTS 




01660 


DCNE 


EQU 


* 



Listing 2: password 

10 'PASSWORD 

20 "BY JOEL MATHEW HEGBERG 

30 'COPYRIGHT (C) 1992 

40 'BY FALSOFT. INC. 

50 'RAINBOW MAGAZINE 

60 • 

70 'JOEL MATHEW HEGBERG 

80 '936 NORTH TWELFTH STREET 

90 'DE KALB. ILLINOIS 60115 

100 ' 

110 CLEAR1000. 32340 : CLS: PRINT"P0 

KING IN DATA.":PRINT"PLEASE WAIT 

120 U>32340:RESTORE:LN-1000:TL- 

0:LT-0 

130 READ At:IFA$-"**"THEN200 

140 IFLEN(A$)>2THEN170 

150 V-VAL("&H"+At):POKE LC.V:LC- 

LC+1 : LT-LT+V 

160 GOTO 130 

170 V=VAL(A$):IF VOLT THEN PRIN 

T"0ATA ERROR IN LINE #":LN:ST0P 

180 TL-TL+LT:LT-0:LN-LN+10 

190 GOTO 130 

200 READ A$:V-VAL(A$):TL-TL+LT 

210 IF VOTL THEN PRINF'UNLOCATA 

BLE ERROR IN DATA STATEMENTS." :S 

TOP 

220 PRINT:PRINT:EXEC32340 

230 NEW 

1000 DATA 16.0.3E.45.4E,54.45,52 

. 20. 59. 4F, 55, 52, 20. 60, 41. 53, 53.1 

176 

1010 DATA 57.4F.52.44.2E.D.0.0.0 

.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.3 

75 

1020 DATA 0.0,0.0,0.34.66,A6,80. 

10.2/,0./.AD.9F,A0.2,16,FF,F3,15 

24 

1030 DATA 35.66,39.30,8C.BF,17.F 

F. E8. 17. 1.1 1.30, 8C.CC, 31. 8CD4.1 

935 

1040 DATA C6.0.A6,A0.A7,80,5C,C1 

.R.10,?5.FF.F5.BF.1.D,AF.8D,0,21 

1250 CATA 19.30,8D.0.4.BF,1.D,39 

.34.76.B6.1.56.81.BD.10.27.0.9C, 

1448 

106e DATA 35.76.6E.9D, 



9F.1.68.B6.FF.1.84.F7.B7.FF.1.22 

93 

1080 DATA B6.FF.3.84.F7.37.FF.3. 

B6,FF,23,8A.8,B7.FF.23.39.17.FF. 

2686 

1090 DATA E4.5F,34.4,C4.FC.F7.FF 

, 20. 35, 4. 53. 10. 8E. 0.50. IE. 2. 83.1 

902 

1100 DATA 0.1.1E.2.10.8C.0.0.10. 

26,FF.F1.C1,80.10.24.FF.DD.5C16 

80 

1110 DATA C1.80.10.26.FF.D5.39.1 

7.FF.B5.C6.14.8E.0.C8.34.4.C4.21 

72 

1120 DATA FC,F7,FF.20.35,4,53.10 

,8E. 0.96. IE. 2. 83. 0.1. IE. 2. 10. 144 

6 

1130 DAIA 8C.0.0.10.26.FF.F1.1E. 

1.83.0.1.1E.1.8C.0.0.10.26.FF.13 

33 

1140 DATA D5.39.0.0.FC.1.68.CD.8 

D.FF.F7.30.8D.FF.61.BF.1.68.17.2 

367 

1150 DATA FF.8A.17.0.34.30.8D.FE 

.F9.31.8D.FE.EA.C6.B.A6.A0.10.23 

89 

1160 DATA 27, 0. 14. Al. 80. 10. 26.0. 

8.5A,10.27,0.F.16.FF.EC.17.FF.13 

61 

1170 DATA 95.16.FF.D6.A6.84.10.2 

6 . FF , F4 . EC .80 . FF. BC . FD . 1 . 68 . 16 . 2 

691 

1180 DATA FF.1C.C6.0.30.8D.FE.C3 

,AD.9F,A0.0.10.27.FF.F8.81.8.230 

6 

1190 DATA 10, 27,0, IE. 81. D. 10. 27. 

0.24.81.20.10.25.FF.E6.81.7F.127 

3 

1200 DATA 10,22.H-,L0,C1,B,10.24 

.FF.DA,A7.80.5C.16,FF,D4,C1.0.23 

27 

1210 DATA 10.27.FF.CE.A6.82.5A.1 

6.FF.C8.C1.0.10.27.FF.C2.C1.3.22 

80 

1220 DATA 10. 27.0. 2. 6F, 80. 39.0.* 

*. 41190 



.77.1A.50. 

85 

1070 CATA 0.85.FD.1, 



0,34 
7. 1.56. EC. 8D, 16 

.35.77.6E. 
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Tfet ULTIMATE Gator Computer \ 



If you want to write fast machine language programs 
but you don't want to spend the next few years trying 
to write them in Assembly Language , then CBASIC is 
the answerlll 

CBASIC is the only fully integrated Basic Compiler and 
program editing system available for the Color 
Computer. It will allow you to take full advantage of all 
the capabilities available in your color computer 
without having to spend years trying to learn assembly 
language programming. CBASIC allows you to 
create, edit and convert programs from a language 
you are already familiar with Extended Disk Color 
Basic, into fast efficient machine language programs 
easily and quickly. 

"The most complete Editor/Compiler I have 
seen for the CoCo... "-The RAINBOW March 
1986 

CBASIC is a powerful tool for the Beginner as well 
as the Advanced Basic or M.L. programmer. CBASIC 
features well over 1 50 compiled Basic Commands and 
Functions that fully support Disk Sequential and Direct 
access files, Tape, Printer and Screen I/O. CBASIC 
supports ALL the High and Low Resolution Graphics, 
Sound, Play and String Operations available in 
Enhanced Color Basic, including Graphics H/GET, H/ 
PUT, PLAY and H/DRAW, all with 99% syntax 
compatibility. 

Specify Coco 1, 2 or 3 Disk $149.00 
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AUTOPILOT and AUTO-LOG Processors 
XMODEM DIRECT DISK FILE TRANSFER 
VT-100 & VT-52 TERMINAL EMULATION 

• No lost data even at 2400 Baud on the Serial I/O port. 

• 6 Selectable Display Formats, 32/40/64/80 columns 

• ASCII & BINARY disk file transfer via XMODEM. 

• Directly record receive data (Data Logging). 

• VT-100 emulation for VAX, UNIX and other systems. 

• VT- 100/52 cursor keys, position, PF & Alt. Kbd. keys. 

• Programmable Word Length, Parity, Stop Bits 

• Complete Full and Half Duplex operation, 

• Send full 128 character set from Keyboard . 

• Complete Editor, Insert, Delete, Change or Add . 

• 9 Variable length, Programmable Macro Key buffers. 

• Programmable Printer rates from 1 10 to 9600 Baud. 

• Send Files from the Buffer, Macro Key Buffers or Disk. 

• Display on Screen or Print the contents of the Buffer. 

• Freeze Display & Review information On line . 

• Built in Command Menu (Help) Display. 
Supports: Modem-Pak & Deluxe Pak or Serial Port 

Specify Coco 1, 2, 3 Disk $49.95 



C 









EDT/ASM III is a Disk based co-resident Text Editor & 
Assembler. It is designed to take advantage of the 
new features of the COCO 3. It has 8 Display for- 
mats from 32/40/64/80 columns. The disk also con- 
tains a free standing ML Debug Monitor. 
EDT/ASM III has the most powerful, easy to use Text 
Editor available in and Editor/Assembler package for 
the Color Computer. 

* Local and Global string search and/or replace. 

* Full Screen line editing. 

* Load and Save standard ASCII formatted files. 
' Block Moce & Copy, Insert, Delete, Overtype. 

* Create and Edit files larger than memory. 
The Assembler features include: 

' Conditional If/Then/Else assembly. 

* Disk Library files up to 9 levels deep. 

* Supports standard Motorola directives. 
Allows multiple values in FCB/FDB directives. 

' Allows assembly from Buffer, Disk or both. 
Specify Coco 1, 2 or 3 Disk $59.95 
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The SOURCE will allow you to easily and quickly 
Disassemble machine language programs directly 
from disk and generate beautiful, Assembler Source 
Code, And " The Source" has all the features and 
functions you are looking for in a Disassembler . 

* Automatic Label generation. 

* Allows specifying FCB, FCC and FDB areas. 

* Disassembles programs directly from Disk. 

* Automatically locates addresses. 

* Output listing to the Printer, Screen or both. 

* Generates Assembler source directly to disk. 

* Built in Hex/ASCII dump/display. 

' 8 Selectable Display formats 32/40/60/80. 

* Built in Disk Directory and Kill file commands. 

* Menu display with single key commands. 

* Written in Ultra fast machine language. 

Specify Coco 1, 2 or 3 Disk $49.95 



The Ultimate User Friendly Point & Click operating 
System for your Coco 3. Simple enough even for 
children to use, just point and click to run programs, 
select files, do disk or file maintenance or almost any 
task you currently do 
by typing commands. 
You also get things 
like a print spooler, 
Programmable 
Function Keys, a 
Buffered Keyboard, 
Ramdisk, Serial I/O port and Deluxe Pak support along 
with Windows, Icons, Buttons, Pull Down Menus, Edit 
Fields and Mouse functions all in one program. It has 
multiple fonts in 54 possible sizes and styles, 
Enhanced Basic Editing and much much more. It add 
over 50 commands and Functions to Basic to fully 
support the Point & Click System without OS9. 
"..it offers so many features that it Is probably 
underprlced. I recommend this software to all 
CoCo3 owners." -The Rainbow Feburary 1989 

It is completely compatible with existing Basic 
programs and takes absolutely no memory away from 
basic. It requires 1 Disk Drive, 
R.S. hires interface & Joystick 
or Mouse. 

Includes 128 & 51 2K 
Versions Only $69.95 
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Window Writer- A point & click Word Processor, 
powerful formatting capability, works wL.th any printer. 

On screen Italic, bold etc. WYSIWYG $59.95 

"Window Writer is a powerful word processor 

that is fun to use, very user friendly. The 

Envlomment compares favorably to that of 
Microsoft Windows " - RAINBOW Dec. 1989 

Window Wrlter/W - for non W/M owners $79.95 

Window Basic Compiler-similar to CBASIC...$99.00 
Window Edt/Asm - A full featured Assembler...$49.95 
Font/Icon Editors- Basic & M.L. versions $19.95 

Advanced. Programmgre 9ujpft- $24.95 

Ths Memory gama - Concentration game $19.95 

Pegk Accessory PaK-7 resident programs $39.95 

A Completely New and Easy to 

use Terminal Program designed 

specifically for the Coco III. 

With advanced features you would expect to find only 
in a Hi-Priced MS-Dos program. It has a 26 Entry 
Phone Directory with complete Configuration 
information for Communications and Automatic logon. 
Supports the Serial I/O Port up to 2400 baud, Deluxe & 
Modem Pak and the Disto Serial I/O board up to 9600 
baud. It has a Full Screen Text Editor, X/Y Modem File 
transfer support, Split Screen Conference Mode, 
Macro Keys. Full Disk Support including Multifile Copy, 
Kill, Rename, Arc/Un-Arc and Disk Initialize and it is 
Completely Compatible with ADOS. 

Requires 128K, Disk & 80 Col. Display $44.95 

( CoCo III Tool Kit ) 

Disk Commands File Commands 

Backup, Initialize, Arcive, Copy, Kill, 

Directory, Verify, Rename, Erase, View, 

Compare, Search, Edit, Edit, Print, Compare, 

Eraae, Speed Teat, Step Salvage, Search, Verify, 

Rate Teat, Gran Table Teat Arcive, Un-Ardve, 

Analysis i Repair Xmodem Send/Rec. 

The Disk Utility Program that you 
always dreamed of Is now a Reality. 

Coco Tools is a comprehensive disk utility Program 
providing the most complete set of functions available 
for the standard R.S. DOS disk system. Comparable 
in scope and functionality to that of the famous utility 
available for MS-DOS computers "PC-TOOLS"! 

Coco Tools Is also the most Comprehensive Disk 
Repair program available, it Automatically diagnosis 
and repairs file allocation errors, locates corrupt 
directory information and cross linked files. It provides 
fast and easy recovery of deleted files without the 
drudgery normally associated with killed file recovery. 

Requires 128K, Disk & 80 col. display $49.95 

d; i&li 

Savings Up To 35% 

EDT/ASM III $49.95 

Window Master $49.95 

Window Master & Window Writer $79.95 

Deluxe Terminal $34.95 



VISA, MASTERCARD or COD 



Call Toll Free 1-800-383-8529 



(Monday thru Saturday, 8am to 5pm PST). 
To order by mail, send check or money order for the 
amount of the program plus $4.00 for shipping to: 

Cer-Comp Ltd. 

5566 Ricochet Avenue 

Las Vegas, NV 89110 

702-452-0632 



November 1992 



THE RAINBOW 



Feature Program 
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by KENNETH REIGHARD JR. 



autiously you creep through the freshly 
turned field. Your detector indicates mines nearby, 
but in which direction do they lie? The tension 
mounts with each slow step. Suddenly you are 
overcome with fear, and you run in a random 
direction. Then . . . KABOOM! 



Minefield is a logic game for the CoCo 3. 
As written, the program requires a disk 
drive, though I'll show you in a moment 
how to modify it for tape-based systems. 

Before you run Minefield the first time, 
you must create the data file (BESTMI NE . DAT) 
in which it stores the best playing time. Do 
this by entering RUN 570. You can also use 
this method to reset the times stored in the 
file. Once BESTMINE.DAT exists on your 
playing disk, you can run the program 
simply by entering RUN "MI NFI ELD". When 
you run the program, you are prompted for 
whether you have a composite (press C) or 
RGB (press R) monitor. If you are using a 
television, use the Composite option. 

Minefield supports three skill levels: Easy 
is played ona 10-by- 10 grid with lOmines: 
Medium is played on a 20-by-15 grid and 
uses 45 mines; and Hard is played on a 30- 
by-20 grid hiding 99 mines. Select the 
desired skill level by pressing 1 , 2 or 3 on 
the title screen. 

When you first start the game, all the 
squares on the grid (minefield) are covered. 
The object of the game is to uncover all the 
unmined squares without "stepping" on a 
mine. The cursor indicating the current 
square appears in the upper-left corner; use 
the arrow keys to move the cursor to the 
various squares on the grid. 

To place a flag on a square you think 
contains a mine, simply move the cursor to 
that square and press ENTER. The mine 
counter in the upper-right comer of the 
screen will decrease by one. If you later 
change your mind, you can remove the flag 
by again selecting that square and pressing 
ENTER. It isimportantthatyou understand 
the mine counter is based on the number of 
flags you place and has nothing at all to do 
with whether or not mines actually exist at 
their locations. You cannot place more 
markers than the number of mines on any 
given level. 

To uncover a square, select it with the 
cursor and press the space bar. If the square 
contains a mine, well . . . let's just say the 
game is over. If this happens, all hidden 



mines are revealed and any flags you have 
placed inaccurately are indicated with an X. 
If you are lucky and don't step on a mine 
when you press the space bar, you will see 
either a blank space or a number. A blank 
indicates there are no mines hidden in any 
of the eight adjacent squares. (Yes, diago- 
nals count in a minefield.) At this point the 
game reveals all blank squares adjacent to 
the selected square in all directions until 
number squares are reached. A number 
indicates the number of adjacent squares 
that contain mines. For example, if a square 
contains a 2, you know there two mines 
next to it. 

When you uncover all the squares that 
don't contain mines, your playing time is 
displayed. Scoring is based on the time it 
takes you to solve an entire minefield. 11' 
your time is the best score for the current 
playing level, you arc asked to enter your 
name. Minefield is designed to save the best 
time from each level in the BESTMI NE . DAT 
file on disk. This routine must be sacrificed 
if you are using a tape-based system. To 
remove the routine, delete lines 485 through 
495,510through550,and570through585. 

Remember that Minefield is for the most 
part a logic game. As tempted as you might 
become, try to guess as little as possible. 
However, there are some possible number 
combinations on the grid that will force you 
to guess at times. After all, luck has a little 
to do with it in real life, too. 




Ken Reighard Jr. is studying computer 
science and engineering at the University 
of Toledo, where he is also a member of the 
Triangle fraternity '. He can be contacted at 
2F441 Ridgeland Drive, Toronto, OH 
43964. (614) 537-4875. Please include an 
SASE when requesting a reply. 



Arrows move cursor around grid 

ENTER a) set flag for possible mine location 

b) remove existing flag marker 
Space Bar uncover selected square 

Figure 1: Minefield Key Commands 



The Listing: hinfield 



'MINEFIELD 

•BY KENNETH REIGHARD. JR. 

•COPYRIGHT (C) 1992 

•BY FALSOFT. INC. 

•RAINBOW MAGAZINE 

GOTO 10 

HPAINT(H*8+16,V«8+16).0,2:RETU 



2 
3 
4 
5 
6 
RN 

7 HPAINT(H*8+16,V*8+16).4.2:RETU 
RN 

8 HPAINT(H*8+16,V*8+16).3.2:RETU 
RN 

9 HPAINT(H*8+16.V*8+16).1.2:RETU 
RN 

10 CLS: INPUT"M0NIT0R (R/C)";Qt 
15 IF Q$-"C" THEN PALETTE CMP EL 
SE PALETTE RGB 

20 POKE 65497.0 

25 DIM M(29.19). N(29.19). N$(3) 

. T(3). SXU00). SY(100) 

30 WIDTH40:CLS3:ATTR 3.2 

35 HC0L0R 3.8:HSCREEN 2 

40 HPRINTf 15.1). "MINEFIELD !":HPR 

INT(8.3)."By Kenneth Reighard. J 

r." 

45 HPRINT(15.6)."1. Easy":HPRINT 

(16, 7). "2. Medium":HPRINT(16.8). 

"3. Hard" 

50 Q»-INKEY»:SK-VAL(Qt):IF SK<1 

OR SK>3 THEN 50 

55 HPRINT(10.20)."One Moment Pie 

ase. . ." 

60 ON SK GOTO 65.70.75 

65 MX-9:MY-9:B-10:GOTO 80 

70 MX-19:MY-14:B-45:G0T0 80 

75 MX-29:MY-19:B-99 

80 L-B 

85 Ft-"C8B06BR4U5FL' - :B$=":88D6BR 

4H2E2F2G2U4" 

90 R-(MX+1)*(MY+1)-B 

95 H-P.ND< -TIMER) 

100 FOR Z-l TO B 

105 H-RNDiMX+l)-l:V-RND(MY+l )-1 

110 IF M(H.V)--1 THEN 105 ELSE M 

(H.V)— 1 

115 NEXT Z 

120 FOR V-0 TO MY: FOR H-0 TO MX 

125 IF M(H,VK>-1 THEN 155 

130 FOR Y— 1 TO 1:F0R X— 1 TO 1 

135 IF X-0 AND Y-0 THEN 150 

140 IF H+X<0 OR H+X>MX OR V+Y<0 

OR V+Y>MY THEN 150 

145 IF M(H+X.V+Y)<>-1 THEN M(H+X 

.V+Y)-M(H+X.V+Y)+1 

150 NEXT X.Y 

155 NEXT H.V 

160 HC0L0R 2.8:HCLS 

165 HPRINT(34.0). "Mines" 

170 HLINE(15.15)-(MX*8+23.MY*8+2 

3J.PSET.B 

175 HPAINT(16.16).4.2 

180 FOR X-0 TO MX 

185 HLINE(X*8+15.15)-(X*8+15.23+ 

MY*8).PSET 

190 NEXT X 

195 FOR Y-0 TO MY 

200 HLINE(15.Y*8+15)-(23+MX*8.Y* 

8+15). PSET 

205 NEXT Y 

210 H-0:V-0:T-0 

215 TIMER-0 

220 HC0L0R 7 :HLINE(H*8+15. V*8+15 

)-(H*8+23,V*8+23).PSET,B 

225 IF R-0 THEN 440 

230 T-T+TIMER: TIMER-0 

235 HC0L0R 2:HLINE(288.B)-(304.1 

6).PRESET.BF:HPRINT(35.1).L 

240 Q$-INKEY$:IF Q$-"" THEN 240 

245 HC0L0R 2:HLINE(H*8+15.V*8+15 

)-(H*8+23.V*8+23).PSET,B 

250 IF Q$-CHR$t8) THEN H-H-1:IF 

IK0 THEN H-MX.-G0T0 220 ELSE 220 

255 IF Q$-CHRt(9) THEN H-H+l : I F 

H>MX THEN H-0:GOTO 220 ELSE 220 

260 IF Q$-CHR$U0) THEN V-V+1:IF 

V>MY THEN V-0:GOTO 220 ELSE 220 
265 IF Q$-CHR$(94) THEN V-V-l: IF 

V<0 THEN V-MY:G0T0 220 ELSE 220 
270 IF Q$-CHRt(13) THEN IF N(H.V 
)-0 AND L>0 THEN G05UB 9:HURAW"ti 
M"+STR$(H"8-H5)-t-"."+STR$(V*8+15) 
+F$:N(H.V)-1:L-L-1:G0T0 220 ELSE 

IF NCH.Vl-1 TH£N GOSUB 7:N(H.V) 
-0:L-L+1:GOTO 220 E.SE 220 
275 IF QSOCHR*(32) THEN 220 
280 IF N(H.V)O0 THEN 220 
285 C-M(H.V) 



290 GOSUB 6 

295 IF C— 1 THEN 400 

300 R-R-l 

305 IF C-0 THEN N(H,V)-3:G0T0 32 

5 

310 HC0L0R 3:HPRINT(H+2.V+2).CHR 

$(0+48) 

315 N(H.V)-2 

320 GOTO 220 

325 0H-H:0V-V 

330 ST-1:SX(ST)-H:SY(ST)-V 

335 IF ST-0 THEN H-OH : V-0 V: GOTO 

220 

340 X-SX(ST):Y-SY(ST) 

345 FOR H-X-l TO X+1:F0R V-Y-l T 

Y + l 

350 IF H<0 OR H>MX OR V<0 OR V>M 

Y THEN 390 

355 IF N(H.V)<>0 THEN 390 

360 IF M(H.V)>0 THEN N(H.V)-2:R- 

R-1:G0SUB 6:HC0L0R 3:HPRINT(H+2 . 

V+2).CHR*(M(H.V)+48):G0T0 390 

365 IF M(H.V)— 1 THEN 390 

370 GOSUB 6 

375 N(H.V)-3 

380 R~R-1 

385 ST-ST+1:SX(ST)-H:SY(ST)-V:G0 

TO 340 

390 NEXT V,H 

395 ST-ST-1:G0T0 335 

400 G0SU8 8:HDRAW"BM"+STRJ(H*8+1 

5 )+" . "+STRS ( V*8+1S )+B$ : PLAY"01 L2 

55V31CDFFGAFGFnCGFV15" 

405 FOR V-0 TO MY: FOR H-0 TO MX 

410 IF M(H.V)— 1 THEN GOSUB 8:HD 

RAW"BM"+STR$(H*8+15)+"."+STR$(V* 

8+15)+B$ 

415 IF N(H.V)-1 AND M(H.V)<>-1 T 

HEN GOSUB 9:HDRAW"C3BM"+STR$(H*8 

+ 15 ) i " . "+STRK V-8+15)+"F8BU8G8" 

420 NEXT H.V 

425 HC0L0R 2:HPRINT( 14.23) . "Pres 

s Key ... " 

430 QS=INKEY$:IF QJ="" THEN 430 

436 GOTO 480 

440 T-T+TIMER:T=INT(T/60) 

44b HCUL0R2:HPKlNI(15.22)."lime- 

"+STR$(T):HLINE(H*8+15,V*8+15)-( 

H*8+23,V*8+23),PSET.B 

450 FOR V-0 TO MY: FOR H-0 TO MX 

456 IF M(H.V)— 1 AND N(H.V)<>1 T 

HEN GOSUB 9:HDRAW"BM"+STR$(H*8+1 

5 )+" . "+STRJ ( V*8+l 5 )+FJ 

460 NEXT H.V 

465 PLAY"02L4CEFL2GL4DFGL203CP2 

470 HC0L0R 2:HPRINT(14.23)."Pres 

s Key ... " 

475 Q$-INKEY$:IF Q$-"" THEN 475 

480 POKE65496.0 

485 OPEN "I".#l. "BESTMINE.DAT" 

490 INPUT #1,N$(1),T(1).NS(2).T( 

2).N$(3).T(3) 

495 CLOSE #1 

500 HSCREEN 

505 CLS 

510 NS-0:IF R-0 THEN IF T<T(SK) 

THEN PRINT"You've beat the best 

time!":LINEINPUT"Enter your name 

:":N»:T(SK)-T:N$(SK)-NJ:NS-1 
515 PRINT:PRINT"Best T!mes":PRIN 
TSTRINGS(40.42); 
520 PRINTUSING"Easy 



(1) 
525 
(?) 
5 30 
(3) 



":T 



MM ";T 



::PRINTN$(1) 
PRINTUSING"Med1uir 

::PRINTN$(2) 
PRINTUSING"Hard 

::PRINTN$(3) 
535 IF NS-0 THEN 555 
540 OPEN "0".#1. "BESTMINE.DAT" 
545 WRITE#1.N$(1).T(1).NK2).T(2 
).NJ(3).T(3) 
550 CLOSEtfl 

555 PRINTSTRING$(40.42);:PRINT:P 
RINT"Play Again (Y/N)?" 
560 0$-INKFY$:IF 0$="Y" THEN RUN 
20 ELSE IF Q»-"N" THEN END ELSE 
560 
565 END 

570 OPEN "0".//l. "BESTMINE.DAT" 
575 WRITE//1 . '•" . 9999 . "" . 9999 , "" . 9 
999 

580 CL0SE//1 
585 END 



/^i 



DELPHI -Theill per hour online solution! 



DELPHFs 20/20 Advantage Plan sets the standard for online value: 
20 hours for only $20, for all the services you want! 

• Thousands of files to download. 

• Chat lines with hundreds of participants. 

• Worldwide e-mail. 

• Hobby and computer support groups. 

• Multi-player games. 

• Local access numbers 
in over 600 cities and towns. 



Trial Offer: 5 hours for $5! 

Try DELPHI at $1 per hour. Join today and get 5 hours of evening and weekend 
access for only $5. If you're not satisfied, simply cancel your account before the 
end of the calendar month with no further obligation. Keep your account active 
and you'll automatically be enrolled in the 20/20 plan for the next month. 

1. Via modem, dial 1-800-365-4636. 

2. When connected, press RETURN once or twice. 

3. At Password, enter RB55 

Questions? Call 1-800-695-4005. 

Rates apply for evening and weekend access from within the mainland US. There is a one-time enrollment fee of $19 
when you join the 20/20 Advantage Plan. Further details are provided during the online registration. 





DELPHI is a service of 

General Videotex Corporation 

1030 Massachusetts Avenue 

Cambridge, MA 02138-5302 

800-695-4005 • 617-491-3393 
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A Hexadecimal Trick 



Some years ago I came across a trick, for 
converting hexadecimal numbers into 
ASCII by taking advantage of binary-coded 
decimal numbers. I'll show you this simple 
trick and explain how it works. Let's start 
by looking at the problem. 

A short segment from the standard ASCIT 
chart appears in Figure 1. To convert a 
value from $0 through $9 to its ASCIT 
value, we can simply add $30 to get the 
correct ASCII code ($30 through $39). So, 
our first attempt at an assembly-language 
Hex-to-ASCII conversion is the single 6809 
instruction: 

adda #$30 

However, this doesn't work for numeric 
values higher than 59. We can almost get 
around this by thinking in terms of binary- 
coded decimal (BCD) numbers. In BCD, 
each digit from the decimal number is rep- 
resented by four bits (a nibble). For ex- 
ample, 78 1(| (the subscript 10 indicates a 
base of 10 — a decimal number) is repre- 
sented in BCD as 0111 1000 since the 
binary nibble 01 1 1 is the same as decimal 7 
and 1000 is decimal 8. (Notice that in straight 
binary conversion, 78 10 becomes 
01001 1 10,.) Since two nibbles (represent- 
ing two decimal digits) conveniently fit 
into one byte, BCD numbers are often stored 
in this form. A chart of the decimal digits 



ASCII 


I 

2 
3 
4 
5 



9 

@ 
A 
B 
C 

D .: 

E 

F 



Hexadecimal 



Figure 1: ASCII Values 



hex2asc tfr 


a.b 


Make a copy of A in B 




anda 


#$0F 


Mask off lower hex diqit 




adda 


#$90 


Convert digit to ASCII 




daa 








adca 


#$40 






daa 








exg 


a.b 


Move ASCII to B„. restore A 




Isra 
















Isra 








lsra 




Select upper hex digit 




adda 


#$90 






, , daa 








adca 


#$40 






daa 






j 


rts 




Return two bytes of ASCII 






Figure 3: Hex-to-ASCII Routine 





is almost the ASCII code for the character 
A. So our second attempt at conversion is 
two instructions: 



Decimal 

2 

3 

4 

5 

6 

7 

8 

9 

n/a 

n/a 

n/a 

n/a 

n/a 

n/a 



1010 
1011 
1100 
1101 
1110 

mi 



Figure 2: Decimal/BCD Equivalents 



adda 
daa 



#$30 



This generates a carry for values higher 
than nine. Combining this with the idea 
above, and compensating for the addition 
of $90, we end up with the following code 
segment: 



and their BCD equivalents is shown in 
Figure 2. 

Looking again at Figure 1 , we see that 
adding $30 to 10 (the decimal value of Hex 
A) using BCD addition gives us $40, which 



The daa instruction (which stands for 
decimal adjust accumulator) is used to 
convert a normal addition in Register A into 
a BCD result. It can be used only after an 
addition or subtraction instruction since it 
relies on the value of the half-carry flag. 
(This flag is set only by addition and sub- 
traction instructions, so the daa instruction 
can't be used to simply convert a number to 
BCD.) 

This second attempt results in a conver- 
sion that is different only by a value of one 
for Hex values above 10. If we could find 
some way to set the carry for values above 
nine, we could use an "addition with carry" 
to get the right answer. A compare instruc- 
tion such as CMPA #10 will set the carry for 
values below 1 0, which is exactly the oppo- 
site of what we want. So we'll use another 
trick with BCD arithmetic: 



adda 


#$90 


daa 




adca 


#$40 


daa 





This short segment correctly converts 
any single hexadecimal digit into its ASCII 
value. Using this, we can write a short 
routine to convert a value in Register A into 
two ASCII digits in registers A and B. One 
version of the resulting routine is shown in 
Figure 3. 

Not all programmers use the same pat- 
tern for naming variables and data struc- 
tures. Even one programmer uses different 
approaches at different times. Next time 
we'll look at how your choices affect binary 
housekeeping. 



adda 
daa 



#$90 



Tim Kientzle is currently pursuing a 
doctorate in mathematics at the University 
of California at Berkeley. He is the author 
of V-Term and has worked with the Color 
Computer since 1982. 



Feature Program 



Queues 

Keep You In Line 
Keep You In Line 
Keep You In Line 



trates a simple use for queues in BASIC 

g. The program first draws an X in the 

screen. It then divides the screen into four 

ach of which it draws another X. These 

the screen and more X's are drawn, 

ntinues. 



The way Xqueue does this is by using a from the other. This is similar to a line at the 
queue. A queue is merely a list to which bank in which people start at the end of the 
items are added at one end and taken off line, and the teller waits on the person in the 




front. Xqueite uses two arrays, A and B, to 
hold the screen coordinates for the center of 
each X added to the queue. 

Variable M in Line 20 controls how far 
from the middle X each of the smaller X's 
are drawn. Variable R in the same line 
reflects the rate at which the size of the X's 
decreases. These two variables are the best 
to change in order to produce different- 
looking results. Variable L used in lines 70 
and 80 represents the length of the current 
X. Throughout Xqueue, I is used to indicate 
the location in the arrays that contains the 
coordinates for the next X to be drawn. 
Similarly, N indicates the location in the 
arrays where the next coordinates can be 
put in the queue. 

Unless you use your imagination. Xqueue 
is a "do-nothing" program — though it does 
draw a fairly interesting design. With a 
little thought, however, you can put queues 
to work in your programming efforts. 



Joseph Pendell lias a degree in electri- 
cal engineering from the University of 
Maryland. In addition to programming the 
Color Computer. Joseph enjoys using the 
Macintosh. His hobbies include riding 
skateboards anil playing Super Nintendo. 



16K Extended 



The Listing: XDRAW 

1 'XURAW 

2 'BY JOSEPH PENDELL 

3 'COPYRIGHT (C) 1992 

4 'BY FALS0FT. INC. 

5 "RAINBOW MAGAZINE 
20 M-.8:R-3.3 

30 DIM A(90),B(90) 

40 A(0)=128:B(0)=96:L=80 

50 I-0:N-1:S1-1:S2-1 

60 PM0DE 4.1:PCLS:SCREEN1,1 

70 LINE(A(I)-L.B(I)-L)-(A(I)+L.B 

(I)+L),PSET 

80 LINE(A(I)-L.B(I)+L)-(A(I)+L,B 

(I)-D.PSET 

90 LS-M*L 

100 'STORE 4 NEW LOCATIONS 

110 A(N)-A(I):B(N)-B(I)-LS 

120 A(N+1)=A(I)+LS:B(N+1)=B(I) 

130 A(N+2)=A(I):B(N+2)=B(I)+LS 

140 A(N+3)-A(I)-LS:B(N+3)-BU) 

150 N=N+4 

150 S2=S2+1:IF S2>S1 THEN S1=S1* 

4:L=L/R:S2=1 

170 1=1+1 : I F N<85 THEN 70 

180 'DRAW THE LAST ROUND OF X'S 

190 F0RJ-I TO (N-l) 

200 LINE!A(J)-L,B(J)-L)-(A(J)+L. 

BCJHD.PSET 

210 LINE(A(0)-L.B(J)+L)-(A(0)+L. 

B!J)-L).PSET 

220 NEXTJ 

230 GOTO230 /«\ 
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CoCo 4-pin DJN Butter DB-25 

1 ;: 



n/c 

20 



Description 

(not connected ) 

(busy signal handshake from buffer to CoCo) 

(ground) 

(serial data to buffer) 



Figure 1: Printer Cable 



Where to Find 6309 Info 

^^k Where con ! find more information about 
^B^ the Hitachi 6309' What about support 
far using it under Disk BASIC' 

Dennis McMillian (COCOKIWI) 
Pittsburgh, California 

AChet Simpson (HYPERTECH) of Hen- 
derson, Nevada, posted on Delphi some 
new material on the technical aspects of the 
6309 and on how to use its features with Disk 
BASIC. In both the CoCo and OS-9 SIGs can be 
found versions of his 35-pagc document that 
details the I Iitachi 6309 opcodes. Chet"s work is 
extensiveand very professional. It is aeombina- 
tion of information obtained from the original 
document from Japan that we've had for the last 
couple of months plus information he obtained 
by experimenting with the 6309 over the last 
month. Chet also provides programs to patch 
the NMl routine of Disk BASIC in order lo 
allow the 6309 to operate in native mode. Chet's 
package is a total of about 1 30K characters. 

The entire package is available in the CoCo 
SIG in TC archive format (about 90K). The text 
file (minus the BASIC patch programs) is avail- 
able in the CoCo SIG in an uncompressed ASCII 
file (about 130K), and in a .ZIP fde (about 
25K) for the convenience of users of other 
computers. The entire package is also available 
in the OS-9 SIG in an AR archive file (about 
45K). Chet says he is preparing other material 
relevant to the 6309, including patches for vari- 
ous BASIC programs. Specifically he is work- 
ing on patches to some graphic display pro- 
grams that will take advantage of the vastly 
faster block-move capabilities of the 6309. 

Again a reminder for those interested in the 
6309: Burke & Burke has a set of patches for 
OS-9 bundled with a 63B09E chip with instal- 
lation instructions called PowerBoost. Burke & 
Burke also has available a book on the 6309. 
Cer-Comp, at last report, is putting the finishing 
touches on a Disk BASIC assembler for the 
6309. 

6309 Information 

^^^ Many of you have asked what is involved 
^^ in using the 6309 with Disk BASIC, and 
whether or not it would involve too many patches 
to specific software. Art Flexser (ARTFLEXSER) 
has provided the following information: 

A With patches for the NMI routine of Disk 
BASIC (to take account for the extra 
register pushed on the stack when an NMI is en- 
countered) Disk I/O will work. You have to 
patch some constants in the sound routine to get 
proper tones and also patch the baud constants 
in the "bit banger" RS-232 generator of BASIC 
to get your printer port to work at a proper speed. 
After this, all ordinary programs written in 
BASIC (apart from some with hidden machine- 
language code that has critical timing loops) 
should run fine and benefit from the 5 to 10 
percent overall speed increase available due to 
the more efficient cycle times of the 6309 in 
native mode. Assembly-language programs such 
as terminal programs and word processors re- 
quire patches to their baud constants for proper 
operation of a printer and modem if the modem 
is being used through the 4-pin "bit banger" port 
on the CoCo. These programs also need to have 
the Disk I/O routines patched to reflect the extra 
register pushed on the stack when an NMI is 
called. Typically LEAS 10 , X has lo be changed 
to LEAS 12,S. cither in Disk BASIC'S NMI 
routine, or in the NMI routine that the specific 
program might set up on its own. 

By far the biggest benefit of the 6309 is in 



cases of programs specifically rewritten to take 
best advantage of it; i.e. graphic display pro- 
grams that do a greal deal of block moves of 
data. Certain highly specialized programs thai 
do mathematical compulations might also bene- 
fit from the 32-bit divide in the 6309. though 
they'd have to be extensively rewritten to take 
advantage of that capability. 

^_ Printer Buffer Needs Help 

flB I just got a Quadrant Microfazer ItiK 
^^X serial-to-parallel buffer. It has inside one 
4164 chip and seven empty sockets. It refuses to 
work when used with my modem cable to hook 
it to my CoCo' s serial port. How can I make it 
work? Can it be upgraded to hare more mem- 
ory? 

I recently bought an old ColorComputer 2 at 
a swap meet and found inside it a little board 
plugged into the VDG socket that had on it a 
VDG and a 24-pin EPROM chip, along with 
several smaller chips. Is this an 80-column 
board? 

Wayne Thompson (WTHOMPSON) 
Sachse, Texas 

A Modem cables and printer cables for use 
with the 4-pin bit banger port are wired 
differently, and they cannot be exchanged. Try 
a cable from the 4-pin DIN socket of your CoCo 
to the DB-25 serial connector of the buffer that 
is wired as shown in Figure 1 . 

You can upgrade that buffer to a full 64K 
capacity merely by plugging in seven more 
4164 chips of virtually any speed (that buffer 
can even use 200ns speed chips). 

The board you describe is not an 80-column 
board. Rather, it is a lowercase board that allows 
the VDG of a CoCo 1 or 2 to access extra 
character data in the EPROM chip on it to put up 
true lowercase characters on the screen. Such 
boards usually had external switches that would 
turn on or off the true lowercase function and 
also allow inverting the video for light on black 
display. The boards usually were specific for a 
given model of CoCodue to mechanical consid- 
erations. 

^_ Double-Sided Access 

flft How can I gain aeee.ss to both sides of a 
^^ double-sided drive with Disk BASIC? I 
am using a Color Computer 3. 

Robert Schmidt (ROBERT84) 
Grand Forks, North Dakota 

A There are two approaches. One is quick 
and dirty and somewhat limited in its ca- 
pabilities, but without cost. The other is elegant, 
convenient and compatible with a wide variety 
of applications, but costs nearly $50. If you are 
running Disk BASIC 2.0 on yourCoCo 3, at the 
BASIC prompt type the following: 

POKE &HD7AC.&H41 
POKE &HD7AD.&H42 

If you have Disk BASIC 2. 1 , type: 

POKE &HD89F.&H41 
POKE &HD8A0.&H42 

At this point Drive 2 will be the back side of 
physical Drive 0, and Drive 3 will be the back 
side of physical Drive 1 (the preferred configu- 
ration for Disk BASIC). You will be able to load 
and save BASIC programs from the back sides 
of disks in those drives (provided you do in fact 
have double-sided drives). The limitations of 
this quick lix are that you still will be using only 
35 of the 40 tracks available; the fix will not 



work with many applications written in assem- 
bly language; and occasionally during a disk 
backup or copy from one side of ihe same disk 
lo another, you might crash the destinalion disk. 
The eleganl and professional approach is lo 
buy a copy of ADOS 3 or ADOS 3 Extended 
from SpcctroSystcms (inquire with 
ARTFLEXSER on Delphi). This will fix your 
system for40-track and double-sided operation 
in a way that is compatible with most (though 
not all) applications with Disk BASIC, elimi- 
nate the problem of occasional crashed copies. 
and add a host of extremely convenient features 
to Disk BASIC. ADOS 3 Extended adds RAM 
disk capability to Disk BASIC if you have 
512K. When you include the cost of having an 
EPROM burned with ADOS 3 Extended, the 
total cost comes to about $50 — bui just about 
everyone who has it says it's well worth it. 

Which BASIC is Which? 

^^^ How can I upgrade an FD-500 disk eon- 
^E£ troller from Disk BASIC 2.0 to Disk 
BASIC 2.1? 

Mike Nelson (MICHAEUN) 
Lancaster, Pennsylvania 

A The version of BASIC you get depends on 
Ihe ROM installed in the disk controller 
and whether you are using a CoCo 1 or 2 or a 
CoCo 3. CoCo 1 's and 2's come up with Disk 
Extended Color BASIC Version 1 .0 or 1. 1 , de- 
pending on what ROM is in the disk controller. 
CoCo 3's, with the same ROMs in the disk 
controller, come up with versions 2.0 or 2. 1 . To 
change from version x.O to version x.l, you 
must buy a licensed ROM chip with the new 
version in it. CoCoPRO! may sell these ROM 
chips, which come in 24- and 28-pin varieties. If 
you have a Tandy controller other than the FD- 
502, you need the 24-pin variety of Disk BASIC 
1.1. Most third-party controllers take 28-pin 
ROM chips, though some also accept 24-pin 
ROM chips and a few very early models of 
third-party controllers actually require a 24-pin 
ROM chip. Your FD-500 controller uses a 24- 
pin ROM chip. 

Note: When looking for the ROM chip on a 
controller, do not confuse it with the floppy disk 
controller chip. Newer controllers use a 28-pin 
WD 1773 disk controller chip. This is not the 
ROM chip! There is not a lot of difference 
between Disk BASIC 1 .0 and 1 . 1 . A few minor 
bugs have been fixed, and one single feature 
(the DO S command used to boot OS-9) has been 
added. ADOS and ADOS 3, by the way, are 
fundamentally patched versions of Disk BASIC 
1.0, with bugs cleaned up and a custom DOS 
command added. 

68B09E Sources 

^^fc Where ran I buy a 68B09E microproces- 
^B^ sor chip? 

Rick McNabb (RICKMAC) 
Citrus Heights, California 

ABG Micro (214-271-5546) used to carry 
the 68B09E for about $4 per chip. If you 
are replacing your 68B09E, you might want to 
consider getting a 63B09E to benefit from its 
lower-power operation and to be able to play 
with the new commands it offers. 

JDR Microdevices listed the 68B09E in the 
last catalog. It was priced at $6.95. JDR does sell 
items in quantity one via mail order, though you 
may be charged a moderate handling fee. 

Orchestra-90CC Files 

^^fc / have a PC compatible with a 1 2MB 
^B^ drive. I wanted it to format disks that your 



MS2C0C0 file-transfer program could read. I 
found that if I formatted disks in that drive with 
the syntax: 

FORMAT A: /4 /l 

[specifying low density with the 1 4 switch and 
singled sided with the I ] switch). I could pro- 
duce a disk that, after I transferred files to it 
from my hard drive, I could read with your 
program. I just thought you'd like to know. 

Now for my question. I downloaded a num- 
ber of Orchestra 90 files from the CoCo SIG 
using my PC compatible, then transferred them 
to my CoCo using Marty Goodman' s file-con- 
version utilities. I then used Mike Ward's 
OCNVRT to convert the ASCII files into binary 
Orchestra 90 files. However, they still won't 
play with Orchestra 90. / get the dreaded ERR 7 
halt that says the file is not found on my disk. Any 
ideas? 

Randy Schmidt (IRMUSER) 
Canton, Ohio 

A Orchestra 90 requires the music files it 
uses not have an extension. So if you have 
on your disk a music file named SONG. EXT, 
rename that file to SONG and it should work 
fine. 

Upgrade the MPI? 

^^A I'm about to buy a used Multi-Pak Inter- 
^B^ face from a fellow who says it is not up- 
graded but that it works well with a CoCo 3. 
What is the upgrade for, and do I really need it? 
Tony Walls (TONYWALLS) 
Janesville, Wisconsin 

A This is a frequently asked question. In 
several RAINBOW articles I have given 
the details of what is involved in upgrading both 
models of Multi-Pak Interface. The older, big- 
ger interface (Radio Shack Cat. No. 26-3024) 
that comes in both gray and white case varieties 
is easily upgraded by replacing a single sock- 
etted PAL chip. This chip is available from 
CoCoPRO! The newer, smaller Multi-Pak In- 
terface (Cat. No. 26-3124) is more complicated 
to upgrade, requiring a trace cut and the addition 
of a patch board with several wires to be sol- 
dered. CoCo PRO! sells kits for this upgrade 
(the schematics are available on the Delphi 
CoCo SIG). My advice is that if you are using a 
Multi-Pak Interface with a CoCo 3, you should 
upgrade it regardless of whether or not it ap- 
pears to work OK. If you f ai I to upgrade, your 
system will experience bus conflicts with the 
GIME chip, which some say can harm Ihe 
GIME chip. 



Martin H. Goodman. M.D., a physician 
trained in anesthesiology, is a longtime elec- 
tronics tinkerer and outspoken commentator- 
sort of the Howard Cosell of the CoCo world. 
On Delphi, Marty is the SIGop of THE RAIN- 
BOW s CoCo SIG. His non-computer passions 
include running, mountaineering and outdoor 
photography. Marty lives in San Pablo, Califor- 
nia. 
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Most CoCo users are continually look- 
ing for ways to improve their systems. And 
the hardware design of the Color Computer 
makes it easy to add improvements. Proj- 
ects may range from simple power indica- 
tors to home control systems. If you have 
built a circuit or devised a modification for 
the Color Computer, why not share it with 
others? 



We are now making tentative plans for 
the March 1993 issue of THE RAINBOW and 
are accepting submissions appropriate for 
that issue's theme. Hardware. We are also 
interested in articles discussing current 
hardware trends as applicable to the CoCo. 
All submissions must be received by us no 
later than November 27, 1992, and must 
follow our standard submission guidelines 
(see Page 3 for details and address). Be sure 
to include schematics, parts lists, and all 
figures and tables. 

We'd also like to see any other programs 
you have written (submitted material must 
be the original work of the submitting party, 
or submitted with written permission). All 
submissions are evaluated and considered 
for publication in future issues. 



Received 

tSert'ified 




The following products have recently 
been received by WE rainbow, examined 
by our staff and issued the Rainbow Seal of 
Certification, your assurance that we have 
seen the product and have ascertained that 
it is what it purports to be. 




Yes! They're still av 




RAINBOW 




BACK ISSUES STILL AVAILABLE 

Have you explored the wealth of information 
in out past i.ysu«&? Ftoiii our very GiM, four- 
page issue to many with more than 300 pages 
of material, it's 'all just for CoCo users — a 
great way to expand your library! 

A WORLD OF INFO 
AT A BARGAIN PRICE 

All back issues sell for the single issue cover 
price. In addition, there is a $3.50 charge for 
trst issue, plus 50 cents for eaeli addi- 
. issue forDOSiaue and handling if sent by 



United Pared Service. There is a S5 charge 

for the first issue,plusa$l charge for each ad- 
| dilional issue on orders sen! by U.S. Mad. 
UPS will not deliver to a post offjxebox or to 
another country. 

MOST ISSUES STILL AVAILABLE 

Available issues through June 1982 are pro- 
vided on while paper in a reprint. form. Ail 
others are in regular magazine form. VISA, 
MasterCard and American Express accepted. 
Kentucky residents please add 6 percent sales 
tax; Canadian residents. 7 percent GST. In 



order to hold down costs, we do not bill, and 
no C.O.D. orders are accepted. 



Due to heavy demand, we suggest you order 

the back issues you want now while supplies 

last 

To order, review and fill out the form below 

and mail it with your payment. 

For greater convenience, order through the 
'Rainbow Magazine Services area of our Del- 
phi CoCo SIC. 




RAINBOW INDEX 

A complete index for, July 1981 through June 1984, is printed in 
the July 1 984 issue. Separate copies are available tor $2.50 plus 50c 
handling. Indexes for subsequent years are published annually in the 
July issues of the rainbow. 

TOTAL 

KY RESIDENTS ADD 6% 

CANADIAN RESIDENTS ADD 7% GST 

U.S. MAIL CHARGE 

SHIPPING & HANDLING 

U.P.S. CHARGE 

TOTAL AMOUNT 

ENCLOSED 

Article Reprints 

In instances where a given issue is now out of orint and not available (or 
purchase, we do provide photocopies of specific articles. The cost tor this 
1 .50 plus 50 cents S/'H per article. This service is provided only in 



the cast 

Name 



! of out-of -stock i 



City State _ 

U Payment Enclosed, orCharge to my: 

Card# 

Expiration Date 

Signature 



_ Zip 
QVISA 



Q MC QAE 



Phone ( ) 



TO ORDER BY PHONE (credit card orders only) call (800) 847- 
0309, 9 a.m. to 5 p.m. EST. All other inquiries call (502) 228-4492. 
send to: THE RAINBOW, The Falsoft Building, P.O. Box 385, 
Prospect, KY 40059 

Please send me the following back issues: 



AUG 83 
SEP 83 
OCT 03 
MAR 94 



VOLUME 3 
Games 
Education 
Graphics 



S2.95 J 
$2.95 a 
S3 95 J 
S3 95 J 



APR 84 
MAY 84 
JUNB4 
JUL 84 



AUG 84 
SEP 84 
OCT 84 

NOV 84 



Education 
Graphics 
lata ftnmn 



53 95 □ 
53.35 LI 
53.35 U 
53.35 □ 



53.95 J 
$3.95 a 
53.95 a 
53 95 J 



DEC 84 
JAN 85 
FEBB5 
MAR 85 
APR 85 
MAY 85 
JUN 85 
JUL 85 



AUG 85 
SEP 85 
OCT 85 
NOV 85 
DEC 85 
JAN 86 
FEB 86 
MAR 86 
APRB6 
MAY 86 
JUN86 
JUL 86 



AUG 86 
SEP 88 
OCT 86 
NOV 86 
DEC 86 
JAN 87 
FEB 87 
MAR 87 
APR 87 
MAY 87 
JUN87 
JUL 87 



AUG 87 
SEP 87 
OCT 87 
NOV 87 
DEC 87 
JAN 88 
FEB 88 
MAR 88 
APR 88 
MAY 88 
JUN 88 
JUL 88 



AUG 88 
SEP 88 
OCT 88 
NOV 88 
DECB8 
.IAN 19 



Holiday 



Utilities 

Business 

Simulatiors 

Printer 

Music 

Annive'sa'y 

VOLUME 5 

Games 
Education 
Graphics 
Data Comm. 
Holiday 

Utilities 

Business 

Home Help 

Printer 

Music 

Anniversary 

VOLUME 6 

Ganos 

Education 

Graphics 

Data Comm. 

Holiday 

Beginners 

Utilities 

Business 

Home Helo 

Printer 

Music 

Annive^sa'y 

VOLUME 7 

Games 

Education 

Graphics 

Data Comm. 

Holiday 

Beginners 

Utilities 

Business 

Home Help 

Printer 

Music 

Anniversary 

VOLUME 8 

Games 

Education 

Graphics 

Data Comm. 

Holiday 

Beginners 



$3.95 J 
$3.95 a 
$3 95 a 
$3.95 a 
$3.95 a 
$3.95 a 
$3.95 a 
$3.95 a 



$3.95 J 
$3 95 LI 
53.95 Q 
$3.95 a 
$3.95 U 
$3.95 U 
S3.95 U 
$3.95 a 
$3.95 a 
$3.95 a 
53.95 a 
53.95 ij 



$3.95 Q 
53 95 a 
$3.95 a 
$3.95 a 
»3.95 a 
$3.95 Q 
$3.95 a 
$3.95 a 
$3.95 U 
53.95 a 
$3.95 a 
$3.95 a 



S3.95 a 
53.95 a 
$3.95 a 
$3.95 a 
$3.95 a 
$395 a 
$3.95 a 
$3.95 a 
53.95 a 
$3.95 3 
$3 95 a 
$3.95 a 



$3.95 J 
$3.95 a 
$3.95 a 
$3.93 J 
$3.95 J 
$3 95 a 



FEB 89 
MAR 89 
APR 89 
MAY 89 
JUN 89 
JUL 89 



AUG 89 
SEP 89 
OCT 89 
NOV 89 
DEC 89 
JAN 90 
FEB 90 
MAR 90 
APR 90 
MAY 90 
JUN 90 
JUL 90 



AUG 90 
SEP 90 
OCT 90 
NOV 90 
DEC 90 
JAN 91 
FEB 91 
MAR 91 
APR 91 
MAY 91 
JUN 91 
JUL 91 



AUG 91 
SEP 91 
OCT 91 
NOV 91 
DEC 91 
JAN 92 
FEB 92 
MAR 92 
APR 92 
MAY 92 
JUN 92 
JUL 92 



AUG 92 
SEP 92 
OCT 92 
NOV 92 



Fun 



Home Help 

Hardware 

Business 

Printer 

Sum 1 

Anniversary 



VOLUME 9 

Beyond BASIC 

Education 

Graphics 

Data Comm 

Holiday 

Beginners 

Home Help 

Hardwaro 

Business 

Printer 

Summer Fun 



Ann 



ary 



VOLUME 10 

0S-9 

Education 

Graphios 

Data Comm 

Holiday 

Beginners 

Hume Help 

Hardware 

Music 

Printer 

Summer Fun 

Anniversary 

VOLUME 11 

Graphics 

Education 

OS-9 

Data Comm 

Holiday 

Utilities 

Home Help 

Hardware 

Music 

Printer 

Programming 

Anniversary 

VOLUME 12 

Graphics 

Education 

OS-9 

Data Comm. 



S3 95 a 
S3 95Q 
S3 95 □ 
$3 95 □ 
S3 95 LI 
S3 95 a 



S3 95 □ 
$3 95 a 
S3 95 a 
S3 95 a 
S3 95 a 
S3 95 a 
53 95 a 
S3.95 a 
$3 95 a 
S3 95 a 
$3.95 □ 
S3 95 a 



S3 95 a 
S3 95 LI 
S3 95 a 

S3 95 a 
$3 95 □ 
S3 95 a 
S3 95 a 
$3 95 a 
S3 95 a 
S3 95 a 
S3 95CI 
S3 90U 



S3 95 a 
S3 95 a 
S3 95 a 
S3 95 □ 
S3 95 □ 
$3.95 Q 
S3 95 a 
$3 95 U 
$3.95 a 
S3 95 a 
S3 95 a 
S3 95 a 



CF83-12: RS-DOS File Handling, allows 

the creation of programs in Forth that can be 
executed using LOADM and EXEC without 
requiring the user to first load CF83 Forth. 
No license required for distribution of the 
resulting programs. Requires CF83 Forth. 
BDS Software, P.O. Bnx485.Glenview, IL 
60025-0485, (708) 998-1656; $13 with 
printed manual, $10 with manual on disk; 
Canadian orders add $3, all other foreign 
orders add $10; all funds U.S. 

CF83 Public domain Disk No. 1, a group 
of programs for the CF83 Forth system. 
Included are programs for converting CF83 
Forth blocks to Disk BASIC (and vice-versa), 
text characters for PM0DE graphics, a BASIC 
utility for dumping disk directories to ASCII 
files, benchmark comparison software for 
BASIC, assembly language and CF83 Forth, 
text-screen control, and a CF83 Forth demo. 
Requires CF83 Forth. BDS Software. P.O. 
Box 485, Glcnvicw, IL 60025-0485, (708) 
998-1656; $3. 

CoCo Cassette #1 1 9, a variety of programs 
for the CoCo 1 . 2 and 3. This issue includes 
Titles, for adding title screens to BASIC 
programs; Picture Maker, for drawing 
PM0DE4 pictures; Square, a logic game; Disk 
Checker, checks for bad sectors; Hints. 
have a conversation with your computer 
(requires S/SC); Lotto Predictions; Pocket- 
hull, an arcade-style game; RAMTest. a 
memory checker; CoCo Directory Man- 
ager, disk utilities; and Mutant Attack, a 
machine-language arcade space game. T& 
D Subscription Software, 2490 Miles Stan- 
dish Drive, Holland, Ml 49424, (616)399- 
9468; $8. 

CoCo Friends Disk Magazine, a maga- 
zine on disk for Disk BASIC users. Pub- 
lished monthly, the disk includes feature 
articles, puzzles, programs, reviews and 
more. CDFM requires a CoCo 3, an RGB 
monitor and a disk drive. Rick's Computer 
Enterprise, P.O. Box 276. Liberty. KY 
42539, (606) 787-5783; $6 per issue, $16 
for three issues and $30 for six issues. 



The Rainbow Seal of Certification is 
open to all manufacturers of products 
applicable to the Tandy Color Computer. 
regardless of whether or no! those com- 
panies advertise in THE RAINBOW. By 
awarding the Seal, we certify the product 
exists — we have a sample copy and have 
examined it. However, this does not con- 
stitute any guarantee of satisfaction. As 
soon as possible, these products will be 
forwarded to reviewer* for evaluation. 




The CoCo 3 supports two approache 
to c >n trolling the computer's action when 
the BREAK key is pressed. When writing 
programs, yon can use the CoCo 3*s ON 
BRK statement, or you can disable the 
BREAK key altogether. To disable the 
CoCo 3's BREAK key. enter 

POKE &HE414,0:P0KE &HE42A.0 

To enable the BREAK, perhaps after 
critical processing is complete, enter 

POKE &HE414,3:P0KE &HE42A.3 




12 November 1992 



THE RAINBOW 



Feature Article 




Effective communication is the cornerstone of any Community, and the Color Computer market 
is certainly no exception. In support of this and to get the word out about groups and clubs, we asked 
Tony Podraza, president of the Glenside Color Computer Club, if he would agree to an interview 
to be published in THE RAINBOW. Tony did not hesitate in saying " Yes! " 

The interview look place via fax machines (another marvel of rapid communication) over a 
period of two weeks. In some cases the answers Tony provides are the result of discussions with 
other Glenside members. We believe you 'II be as interested in these representative views as we are. 

THE RAINBOW: We understand the Glenside Color Computer Club is one of the largest users 
groups in the CoCo Community. Just how many members do you have? 

Tony: Currently there arc 146 club members who live in the United Stales. Of these, about 30 are 
in this general area and regularly attend meetings. The rest are out-of-state members and live in 
places from California to New Jersey. And we don't restrict membership to U.S. residents: 
Glenside has four members who live in the Netherlands and Canada. 

THE RAINBOW: Wow! Perhaps Glenside is the largest users group for CoCo owners. What makes 
the club so strong'/ 

Tony: Glenside's strength is just that — Glenside. That sounds a bit like the hound chasing its tail, 
doesn't it? Let me explain. The total of Glenside is the sum of its parts: the members make the 
difference. The support we give each other, the information we pass to one another via die 
newsletter, the way we work to help other CoCo users all add up. As one member pointed out, 
' 'the support that Glenside is ready to give to its members and the Community has continued to 
strengthen il from its founding." 

Glenside's exposure to the Community has helped to strengthen it as well. As you know, the 
club has hosted at least four RAINBOWfests and was officially represented at the second 
Atlanta CoCoFEST and the recent Chicago CoCoFEST. All this highlights the commitment of 
the club to the support of the Community. 

THE RAINBOW: Speaking of support, how are membership dues applied and what can club 
members expect from Glenside? 

Tony: Our annual dues are used to cover a number of expenses, the first and foremost of which is 
CoCo~I23, the newsletter that keeps Glenside in touch with Glenside. Second, these funds help 
us keep a meeting place available. We meet at the Glenside Public Library, from which we take 
our club name. Another expense is the maintenance of our club BBS. Also as a benefit of 
membership, wedistribute a "member's utility disk ' ' (written by Joel Hegberg just for Glenside), 
and we have plans to distribute three more disks to the membership at no extra charge. Finally, 
but certainly not least, we use these funds for whatever else we can find to support the club and 
the Community. An example is our involvement in CoCo shows. It is to this support that the 
treasury is directed. Well . . . there is the one exception. We do have an annual social event, most 
recently a picnic, for which the club provides meat and rolls — a whopping $25-$30 at best 
guess. 

Even if they don't live in our area, new members can take advantage of most of these things 
for the membership dues they pay. CoCo- 123 has received a number of kudos from people in 
the publishing world and has become a strong medium of club interaction for the "members at 
large." Indeed, it was an article written by a iocal member that brought one gentleman back to 
our exhibit in Atlanta in 199 1 after he had hemmed and hawed about joining. As he related to 
me, he had already ' 'found about $15 worth of information in the newsletter' ' that he had received 
as part of a free handout package. 

We also have the "Glenside Club Plan" that invites vendors to submit ad copy for publication 
in the newsletter. Reciprocal token discounts on products are welcome for this service but are 
not required. Member savings from this plan are an added benefit. 

Other methods of interaction with the Community include the SIGs on Delphi, where a 
number of members gather: networks set up through STGNet; and hopefully, in the future, 
FIDO. 

It is important to note that membership is not only aprivilege but carries responsibility as well. 
We believe every member has something to share, and we encourage participation via the 
newsletter and club meetings, if possible. 

THE RAINBOW: Describe a typical meeting. 

Tony: Meetings open with the sounding of the electronic presidential gavel — actually a three- 
sound siren repackaged in a gavel-shaped housing sporting a Tandy RAM-button handle. After 
that bit of nonsense is out of the way, visitors and new members are recognized, then we hold 
a short business meeting. Afterthis we share news and views, questions and answers, and maybe 
a little gossip is supported (but never started). During the last half of the meeting, a scheduled 
demo takes place. This could be a run-through of a program or a hardware demo. 

After the meeting, the majority of attendees adjourn to the local restaurant for "milk and 
cookies. ' ' This is where the brainstorming starts to take place. It was at one of these sessions that 
the RGB-A-io-TTL video adapter was spawned. 

THE RAINBOW: Earlier you mentioned a club BBS. Would you give our readers some of the 
details? 

Tony: Yes. The Glenside CoCoRama BBS has been in operation since 1986, anditssysopisDavc 
Barnes. The system is online 24 hours every day and can be reached at (708) 587-9837. Inbound 
callers should sets their terminals at 8-N- 1 for 300-, 1200- or 2400-bps access. The board can 
be used by anyone, though file downloading on the first access is limited. 

In addition to CoCoRama, there are at least two other BBSs currently operating in direct 
support of the club. They are listed in the newsletter and also on the CoCoRama logoff screen. 

THE RAINBOW: We have seen some Color Computer users groups that are really nothing more 
than high-seas boarding parties. What is Glenside ' s position < m the subject of software piracy? 



Tony: I'm glad you asked. As responsible people, we need always to be aware of our actions and 
their effect on others. The wanton passing around of commercial software does nothing but 
discourage authors and vendors from continuing to support the market. Indeed, where is the 
market when you can get the product from your buddy across town? When authors no longer 
produce new software because there is nothing to be gained from it, who's going to write the 
good stuff? Your buddy? 

For the record, Glenside doesn't support software piracy in any form. As stated in our bylaws, 
anyone found using the club system for such practice will he disassociated from the club. These 
[now] non-members forfeit their annual dues, do not receive any club benefits or services, and 
may not rejoin. We don't have a problem. 

THE RAINBOW: What is the personal ' 'toll' ' on you as president of Glenside, and what advice 
would you offer those who seek to start their own clubs? 

Tony: Time and money: I spend many hours on (he phone asking and answering questions, and 
arranging demos and the like for the meetings. The real winner here is the phone company 
that's where the money part comes in. Of course for every hour I spend on Glenside, that's 
another hour not spent with my family. This can be disastrous if not balanced carefully. Finally, 
there is the toll that ethics, politics and tactfulness puts on a person. I have to be very careful in 
what I say and do so as to not misrepresent information. CoCo users are a close-knit family, and 
I have no intention of knocking the feet out from under anybody. The efforts put forth to maintain 
an organization like Glenside without rocking the boat may not be monumental, but they are very 
real. 

Advice for others? First, don't wait for someone else to start it! If you know one other CoCo 
user in your area and there are no organized users groups, gel together wilh thai person: you now 
have a "club." Find a place lo meet — just about anyplace will do. Then get the word out; put 
notices in the library , the grocery store . . . anywhere you can find to let others know you are there. 
Develop a meeting format that the majority of members is comfortable wilh — it doesn't have 
to be formal but should be interesling. Also develop a set of realistic goals and guidelines. If you 
want the club to be ongoing, the core of the club needs to be dedicated and energetic. 

Operating a users group may also require some money to maintain things such as a roof over 
your heads, mailing newsletters, and purchases for the benefit of the club. So after you have an 
idea what your expenses will be, be prepared to initiate an annual amount for membership dues. 
Above all, try to strike a balance. Remember that the club does not belong to any one member 
but is the medium through which all members benefit in terms of knowledge and understanding 
of the CoCo. regardless of their individual preferences. 

THE RAINBOW: What percentage of Glenside's membership uses 05-9? 

Tony: Judging from our meetings and responses from the membership, I would say 75 to 85 percent 
of Glenside's members use OS-9 for 85 to 90 percent of their work wilh the CoCo. I would 
estimate that less than 25 percent of the club membership uses Disk BASIC exclusively. This 
is not to say thai ihe rest of ihe Community follows suit — there are a lol of Disk BASIC users 
oul there. But as knowledge of ihe CoCo's capabilities under OS-9 grows, the percentages are 
starling lo lean in that direction. 

THE RAINBOW: Debute between the diehard OS-9 and Disk BASIC camps is often quite intense. 
Would you say this schism is an inhibiting factor in any potential growth of this market? If so, 
what possible solutions would you suggest? 

Tony: No, not really; not any more than the GUI environment versus DOS environment is an 
inhibiting factor in the IBM (and compatible) world. While it appears to be true thai the future 
growth of this market lies with OS-9, it is very beneficial for users to know a little about Disk 
BASIC before attempting to use OS-9. What is important for people lo undersland is that OS- 
9 is not an enemy bul merely another environment in which to use Ihe hardware. Far too many 
Disk BASIC users end up disliking OS-9 before they receive the support necessary for a clear 
understanding of Ihe system. One of Glenside's goals is to provide that support for both Disk 
BASIC users and those who choose to venture into the world of OS-9. 

THE RAINBOW: It is generally accepted that MS-DOS is the most widely used platform 

across the computing industry. For whom would you say the Color Computer is a viable 
machine and why? 

Tony: For the same people for whom it has been a viable machine since its inception — those who 
are on a light budget and wanl to learn about computing; hobbyists who want to experiment; 
those who want to find oul what true multitasking/multiuser capabilities are like without having 
to buy a 386 or mini-mainframe. Of course that's the serious side. The CoCo is also a pretty fine 
game machine (especially according to Tandy). Unfortunately this aspect has also been the area 
of greaiesi advertising for the machine — to Ihe extent that the real power of the 6809 has been 
hidden from the general public. 

THE RAINBOW: Yes, it is sometimes difficult to enjoy playing games knowing they have been 
somewhat of a stigma to growth. How has Tandy's discontinuation of the Color Computer 
affected Glenside? 

Tony : 1 1 has increased the need for our existence and has made us a stronger voice in the community. 
I think, because of our willingness lo be there for the Community. It goes without saying that 
the product knowledge and support from the local retail outlets for ihe Color Computer has never 
been whal it is for the other systems. Now the average salesperson's desire to support a non- 
income producing item is in Ihe twilight zone. When you need someone to answer a question 
or solve a problem, lo quote a phrase, "who ya gonna call?" Il ain'l Ghostbusters! It'll be your 
local club co-member. And Glenside is just one of those local clubs. We've simply got a bigger 
' 'ear' ' lo hear ihe callers. 

THE RAINBOW: What can Ihe average person do to ensure continued enjoyment of his CoCo? 

Tony: Link up with other CoCo users; be imaginative in using the CoCo. Roberl Kennedy once said. 



THE RAINBOW 



November 1 992 13 




Mike Knudsen (second from left), author ot UlliMusE, regularly attends 
the Glenside Color Computer Club meetings. 



' ' Some people see things and ask 'why?' I dream things thai never were and ask ' why not'.' ' ' ' Tell 
others what you are doing with your CoCo and share your discoveries. You may have found 
something the next person has been working for a long time to solve. The joy of discovery cannot 
be replaced. 

Communication is the key to the survival of the CoCo. Get in touch with other clubs and users 
through whatever means you have, whether that is by telecommunications, newsletters, 
subscriptions to dedicated publicatioas or road trips to gatherings. There arc many "orphaned- 
computer" users groups out there, many of which are thriving simply because they continue to 
communicate. 
THE RAINBOW: We would like to know what comments Glenside has about THE RAINBOW. 
Tony: For starters, how about helping to keep the hardware in the active community by opening 
a "classifieds" section? I belong to a number of national organizations thai produce major 
publications, and all of them publish such a section. 

The current format is really colorful, but the paper it is printed on is not easily preservable or 
long-lasting. Possibly you could do something there. And we'd like to see a return to the 8'/2-by- 
1 1 size, perhaps with stitch binding. 

Wc like the assembly-language programs and would like to sec them continue for both Disk 
BASIC and OS-9. The inclusion of C-language programming articles would be nice. I 
particularly enjoy hardware articles, so those should stay around, too. 

Despite the publisher's comments a few months back regarding the 68xxx machines. I 
believe items relating to them should be considered for publication. The people who have made 
the CoCo what it is are doing the same for those computers. To shy away from 68000-based 
computers because "bunches and bunches of software" are not currently available is not valid. 
And because of the commonality of OSK with OS-9, 1 feel that the software for these machines 
should be covered in the venue of the publication from time to time. 

Finally, there is a lot of murmuring out here about the possibility of a THE RAINBOW 
becoming a merged CoCo/MS-DOS publication, even though most readers are just happy to be 
able to get the magazine. Consider going to a bi-monthly schedule instead, and consider 
reviewing and reducing prices on products. Of course, I don't know the logistics and costs 
involved; I'm just the elected messenger. 

Thank you, Tony, for taking the time to answer our questions and for giving us some honest 
feedback. Your answers are important to us, and they should be of interest to our many readers as 
well. Yes, there are a lot of things we must consider with every decision we make, and while these 
decisions make sense to us, not everyone agrees with them. This doesn't mean we won't make 
changes, but we mast be careful when we do. Regarding a merged publication: we believe those 
fears will prove unwarranted. THE RAINBOW is a CoCo publication. 

Reaching Out 

Now is as good a time as any to make sure you stay in contact with other users of the Color 
Computer. The currently available means to this end include joining users groups, writing letters, 
subscribing to publications, and taking advantage of online services such as Delphi, CompuServe 
and CoCo BBSs. For more information about CoCo clubs and BBSs that may be in your area, sec 
"Intercom" elsewhere in this issue of THE RAINBOW. 

Remember that many clubs accept memberships from distant users. Those interested in joining 
Glenside can write to Glenside Color Computer Club at 1 19 Adobe Circle, Carpentersville, IL 
601 10-1101. Be sure to include $12 to cover the annual membership dues. 




Chris Hawks (center) of Hawksoft answers another user's question. 




Save Money Too! 

Subscribetotheseconvenientservicssandreceiveeachmonth'sprogramsinaready-to- 
run form. No morelongtedioushourswasted typing! No more red eyes and sore fingers! All 
you do is load and run, using the current issue of THE RAINBOW asdocumentation. 

OS-9 programs are available too! One side of the FIAINBOWON DISK is formatted for the 
OS-9 operating system (OS-9 programs cannot be put on tape) so you can get all the great 
programs in themagazine. 

Aone-yearsubscriptiontoTHEFlAINBOVVandFlAINBOWONTAPEisonlyS91intheU.S., 
$1 08 in Canada, $1 53 foreign surface rate and $1 88 foreign airmail. 

Aone-yearsubscriptJontoTHERAINBOWandRAINBOWONDISKisonly$115intheU.S., 
$1 38in Canada, $1 83foreign surfacerate and $21 8foreign airmail. U.S. currency only .Back 
issuesof both RAINBOW ONTAPEand RAINBOW ON DISKarealsoavailable! (seeourback 
issue ad in this issue) 

RAINBOWONTAPEbackissues are available beginning with the April 1 982issue. Asingle 
copy of RAINBOW ON TAPE is $1 within the U.S., $1 2 in all othercountries. The annual 
subscription for RAINBOW ON TAPE is $80 within the U.S. ; $90 in Canada; and $1 05 for all 
othercountries. U.S.currencyonly. 

RAINBOWON DISK back issues are available beginning with the October 1 986 issue. A 
single copy of RAINBOW ON DISKis$12withintheU.S.,$14inCanada,$16inallother count- 
ries.The annual subscriptionforRAINBOWON DISK is$99 within theU.S.;$115inCanada; 
and$130forall othercountries. U.S. currency only. 



Yes! Sign me up for a joint 1 -year subscription (12 issues) to: 

Q THE RAINBOW 
and Rainbow on Tape 

QNew 

Name 

Address 

City 

State 



Q THE RAINBOW 

_ and Rainbow on Disk 

Q Renewal (attach labels) 



Zip 



IJ My check in the amount of is enclosed. 

Charge to: □ VISA □ MasterCard □ American Express 

Account Number 

Expiration Date Signature 

For credit card orders, call (800) 847-0309, 9 a.m. to 5 p.m. EST. All other inquiries 

call (502) 228-4492. 

* Payment must accompany order; we do not bill. U.S. currency only, please. 

Kentucky residents add 6% sales tax; Canadian residents, 7% GST. Please allow 

6 to 8 weeks for delivery of first copies. All subscriptions begin with the current 

issue. 

Please note : While group purchases of RAINBOW ON TAPE and RAINBOW ON DISK 

are permitted (and multiple subscriptions are even discounted if purchased in one order 

from a club), no license to make copies is conveyed or implied. Unauthorized copying 

of any copyright product is strictly illegal. 
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Do You Rest 
Easy at Night? 




THE RAINBOW is the only publication that offers peace of mind to CoCo 
users. Members of the CoCo Community have always looked to THE RAIN- 
BOW for comfort — hints, tips, the latest news and communication with 
others — for their Tandy Color Computers. 

THE RAINBOW continues to serve and support CoCo users, from 
beginners to the advanced, by covering the wide variety of topics affecting 
the CoCo Community. Looking for games? Telecommunications pack- 
ages? Finance programs? Interested in helpful utilities? Hands-on hard- 
ware projects? Want to take the guesswork out of buying software and 
hardware? From Disk BASIC to OS-9, THE RAINBOW has the answers to 
all your CoCo questions. 

Get rid of your nightmares by renewing your subscription today. THE 
RAINBOW — the best security blanket for a good night's rest. 



Use our 800 number! 

For credit card orders, you may phone in your subscription. Our credit 
card order number is (800) 847-0309, 9 a.m. to 5 p.m. EST. We accept VISA, 
MasterCard and American Express. All other inquiries call (502) 228-4492. 



Yes! Please send me RAINBOW Magazine. 

Choose one: J New J Renew (attach label) 

J One Year $31 — 35% off cover price 
'J Two Year $58 — 39% off cover price 
_) One Year $79 — 44% off cover price 



Which Tandy Color Computer do you use? 
LI CoCo 1 U CoCo 2 LI CoCo 3 



Name 
Address 



City 

□ My check in the amount of 

Charge to: J VISA 3 MasterCard 

Account Number 

Expiration Date ___ 



State 



ZIP 



is enclosed. 
□ American Express 



Signature . 



Subscriptions to THE RAINBOW are $31 a year in the United States. Canadian rate is 
$38 plus 7% GST (U.S. lunds only). Surface rate elsewhere is $68 (U.S.). Non-U. S. 
subscribers must inquire about multi-year discount. Airmail is $103 (U.S.). Kentucky 
residents add 6% sales tax. All subscriptions begin with the current issue. Please allow 
6 to 8 weeks for the lirst copy. In order to hold down non-editorial costs, we do not bill. 

For credit card orders, call (800) 847-0309, 9 a.m. to 5 p.m. EST. All other Inquiries 
call (502) 228-4492. 



BUGGY FROM COVER 

within the screen boundaries. Anything 
greater than 191 wraps around to zero and 
any value below zero wraps to 191. (Can 
you figure out why we don't have to check 
the x coordinate?) 

If the current bug's new >• coordinate is 
the same as the "zapper" location, the pro- 
gram goes to ZAP where that point is PRE - 
S ET. Now we have to move all the rest of the 
current locations in L0C down by one to 
replace the bug just lost. Since Register Y 
points to the next bug's location, we reduce 
it by two to reflect the current bug; now load 
the coordinates for the next bug and save 
them at the current location. Keep doing 
this for the rest of the array, then decrease 
the number of bugs by one. 

Finally, we have to shift each bug's 
direction toward the current bug's location 
(still in $BE and SCO). The distance from 
the current bug to each bug is compared in 
the .randy directions. If the current location 
is less than a bug's x coordinate, the new x 
change for that bug is -1 to move it toward 
the current location; if the current location 
is greater, the change is +1; and if the x 
distance is the same, the change is 0. The y 
coordinate changes are computed in the 
same manner, and both changes are stored 
in the DEL array. After the ZAP routine is 
completed, the program goes back lo I 00P1 . 
If no bugs were on the zapper, C0UNT1 (the 
number of times) is decreased. If no bugs 
were on the zapper during any of the. Number 
Of Times, the program goes to the CHANGE 
routine to compute new location changes of 
+ 1 or-1. 

After you've entered the program in 
Listing 2. check it for errors by entering A/ 



NO/NS/WE. Then save it using W BUGS. SRC 
and assemble it using A BUGS. BIN /NS/WE. 
The BASIC program shown in Listing 1 is 
the driver for the machine-language pro- 
gram. It loads the assembled program (if 
necessary) and executes it. The variables 
you can change are: 

N — number of bugs (1-250) 
L — location of the zapper (0-191) 
T — number of times in the same direc- 
tion (1-255) 

If you're just itchin' to increase the 
number of bugs beyond 250, you'll have to 
make NUMB two bytes in length and increase 
the L0C and DEL arrays accordingly. 

For experimentation, try changing the 
zapper location: make it one point instead 
of a line, and revolve that point as if it were 
on a circle. How does the swarm move 
then? 

If you have any suggestions for future 
articles, or questions about any article, don't 
hesitate to write. 



Bill Nee bucked the snowbird trend by 
retiring to Wist onsin flam a bunking ca- 
reer in Florida. The success of his I. '-pan 
series, "Machine Language Made basic" 
(July 1988 in. Inly 1989), prompted him to 
continue writing articles about Color 
Computer machine language program- 
ming. You may contact Bill at Route 2 . Box 
2I6C. Mason. Wl 54856-9302, (715) 746- 
2952. Please include an SASE when re- 
questing a reply. 



64K Disk 



Listing I: 3UGDRIVE 

1 "BUGS DRIVER 

2 'BY WILLIAM P. NEE 

3 'COPYRIGHT (C) 1992 

4 'BY FALS0FT, INC. 

5 'RAINBOW MAGAZINE 
10 CLEAR200.&H6000-1 

20 IF PEEK(&H6004)<>16 THEN LOAD 

M"BUGS":P0KE &HFF40.0 

30 X=RND(-TIMER) 

40 N=200: 'NUMBER OF MOTHS 

50 POKE &H6000.N 

60 L=96:' LOCATION OF ZAPPER 

70 POKE &H6001.L 

80 T=5: 'NUMBER OF TIMES 

90 POKE &H60AB.T 

100 PM0DE4.1:PCLS:SCREEN1.1 

110 EXEC &H6004:CLS 

120 FOR X-l TO 100:NEXT X:CLS 

130 PRINT@200. "THAT'S ALL FOLKS" 

140 GOTO 140 



I 



Listing 2: BUGS 










00100 


ORG 


$6000 






|§P* 


00110 


RANDOM 


MACRO 






A4p7 


00120 




PSHS 


Y 




^pr 


00130 




LDD 


$116 


RANDOM 


SEED 


00140 




LDX 


$118 


RANDOM 


SEED 


00150 




JSR 


$9FB5 


D-X->Y 


U 


00160 




LDD 


$BF74 


RANDOM 


CONSTANT ^^ 


00170 




LEAY 


D.Y 


ADD IT 


TO Y ^^^ 


00180 




STY 


$116 


RESAVE 


^m 


00190 




LDD 


$BF/6 


RANDOM 


CONS 1 AN! ^^F 


00200 




LEAU 


D.U 


ADD IT 


TO U 


00210 




STU 


$118 


RESAVE 


IT 


00220 




LDB 


$117 






00230 




ANDB 


#1 






00240 




INCB 








00250 




LSLB 






^^^ 


00260 




SUBB 


#3 


--1.+1 


4B 


00270 




PULS 


Y 




■p 


00280 




EN DM 








00290 










JBi 


00300 


PSET 


EQU 


$9374 




■MB 


00310 


PP0INT 


EQU 


$933C 




W* ; 


00320 


RND0 


EQU 


$BF3B 






00330 


NUMB 


FCB 


200 






00340 


LEN 


FCB 


96 






00350 


C0UNT1 


RMB 


1 










THE RAINBOW 



November 1992 



15 



00360 C0UNT2 


RMB 


1 




00980 MAXY 


LDB 


#191 




00370 








00990 GETY2 


STB 


.Y+ 


NEW Y COORDINATE 


00380 START 


LDY 


#LOC 


LOCATION ARRAY 


01000 


STB 


$C0 




00390 


LDB 


#$FF 




01010 


LDB 


#$FF 




00400 


STB 


$B5 


CURRENT COLOR 


01020 


STB 


$B5 




00410 


LDB 


NUMB 




01030 


JSR 


PSE1 


PSET NtW COORU1NAIES 


00420 


STB 


COUNT1 




01040 


LDB 


$C0 




00430 RANLOC 


LDD 


#255 




01050 


CMPB 


LEN 


ON THE ZAPPER? ^» , 


00440 


JSR 


$B4F4 


MOVE TO FP1 


01060 


BEQ 


ZAP 


^|H 


00450 


JSR 


$BF1F 


RANDOM(255) 


01070 


DFC 


COUNT? 


: "'£jift ! 


00460 


JSR 


$B3ED 


MOVE BACK TO D 


01080 


BNE 


L00P2 


^^p 


00470 


STB 


$BE 


AND SAVE IT 


01090 


DEC 


COUNTl 




00480 


LDD 


#191 




01100 


BNE 


LOOP1 


m 


00490 


JSR 


$B4F4 




01110 


LBRA 


CHANGC 


■ 


00500 


JSR 


$BF1F 




01120 






-%v 


00510 


JSR 


$B3ED 




01130 ZAP 


CLR 


$B5 




00520 


STB 


$C0 




01140 


JSR 


PSET 


CLEAR THE POINT 


00530 


JSR 


PPOINI 


CHECK 1HAI LOCAIION 


01150 


LEAY 


-2.Y 


BACK TO CURRENT COORDINATES 


00540 


JSR 


$B3ED 




01160 ZAP1 


LDD 


2.Y 


NEXT SET OF COORDINATES 


00550 


CMPB 


#5 


ALREADY PSET? 


01170 


STD 


.Y++ 


SAVE THEM AS CURRENT ONES 


00560 


BEQ 


RANLOC 


TRY AGAIN 


01180 


DEC 


COUHT2 




00570 


1 DA 


$BF 




01190 


BNE 


ZAP1 




00580 


LDB 


$C0 




01200 


DEC 


NUMB 


ONE LESS BUG 


00590 


STD 


,Y++ 


STORE THE COORDINATES 


01210 


BEQ 


DONE 




00600 


JSR 


PSET 


AND PSET THE POINT 


01220 








00610 


DEC 


COUNT1 




01230 NDEL 


LDY 


#LOC 




00620 


BNE 


RANLOC 




01240 


LDB 


NUMB 


,.!i25 


00630 








01250 


STB 


C0UNT2 


JmEb 


00640 CHANGE 


JSR 


RND0 


KEEP THINGS HONEST 


01260 NEWDX 


LDA 


$BE 


CURRENT X COORDINATE t 1 


00650 


LDB 


NUMB 




01270 


CMPA 


,Y 


COMPARE TO THE ARRAY *f*' 


00660 


STB 


COUNT1 




01280 


BHI 


INCDX 


IF GREATER 


00670 


LDY 


#DEL 




01290 


BLO 


DECDX 


IF LESS 


00680 DELX 


RANDOM 






01300 


CLRA 




IF THE SAME 


00690 


STB 


.Y+ 


SASVE RANDOM DX WftL 


01310 


BRA 


NDX1 




00700 DELY 


RANDOM 




wtSt 


01320 INCDX 


LDA 


#1 


DX-+1 


00710 


STB 


,Y+ 


SAVE RANDOM DY 1 •*? 


01330 


BRA 


NDX1 




00720 


DEC 


COUNT1 




01340 DECDX 


LDA 


# 1 


DX- 1 


00730 


BNE 


DELX 




01350 NDX1 


STA 


500, Y 


SAVE NEW DX 


00740 








01360 


LEAY 


l.Y 




00750 


LDB 


#5 


NUMBER OF TIMES 


01370 NEWDY 


LDB 


$C0 


CURRENT Y COORDINATE 


00760 


STB 


COUNT1 




01380 


CMPB 


,Y 


COMPARE TO THE ARRAY 


00770 LOOP1 


LDY 


ROC 




01390 


BHI 


INCDY 




00780 


LDB 


NUMB 




01400 


BLO 


DECDY 




00790 


STB 


C0UNT2 




01410 


CLRB 




DY-0 


00800 L00P2 


LDD 


.Y 


CURRENT X.Y LOCATION 


01420 


BRA 


NDY1 


^^^ 


00810 


STA 


$BE 




01430 INCDY 


LDB 


#1 


IHk 


00820 


STB 


$C0 




01440 


BRA 


NDY1 


^|^B 


00830 


CLR 


$B5 


NO COLOR ^^ 


01450 DECDY 


LDB 


#-1 


DY— 1 ^^^ 


00840 


JSR 


PSET 


^^^k 


01460 NDY1 


STB 


500, Y 


SAVE NEW DY 


00850 GETX 


LDA 


$BE 


CURRENT X COORDINATE II 


01470 


LEAY 


l.Y 




00860 


ADDA 


500. Y 


CURRENT DX ^BP 


01480 


DEC 


C0UNT2 


CHECK AGAINST ENTIRE ARRAY 


00870 


STA 


,Y+ 


NEW X COORDINATE 


01490 


BNE 


NEWDX 




00880 


STA 


*BE 




01500 


L8RA 


LOOP1 


^^a 


00890 GETY 


LDB 


$C0 


CURRENT Y COORDINATE 


01510 DONE 


RTS 




^^^B 


00900 


ADDB 


500. Y 


CURRENT DY 


01520 LOC 


RMB 


250*2 


^| 


00910 


CMPB 


#192 


KEEP IT 


01530 DEL 


RMB 


250*2 


^* ^^ 


00920 


BEO 


ZEROY 




01540 FINIS 


NOP 






00930 


CMPB 


#-1 


WITHIN THE SCREEN 


01550 


END 


START 


^P 


00940 


BEQ 


MAXY 












00950 


BRA 


GETY2 












00960 ZEROY 


CLRB 














00970 


BRA 


GETY2 
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Product Review 

CCTools: A Disk 

Manager in Need 

of Management 

I'm always a little wary of disk-file 
managers because often they are loaded 
with bugs, and I've had several cause 
damage to the data on disks to the extent 
that I've had to rebuild the disks. With this 
in mind, I approached reviewing CCTools 
very carefully. My caution was reasonable, 
as I'll show below. 

CCTools is a disk-management program 
that runs under OS-9 Level II. The system 
requires you have a minimum of 512K 
installed in your CoCo 3. The authors rec- 
ommend a large disk (i.e., hard disk) to 
make all of CCTools features useful. 

Even though CCTools is written in BA- 
SIC09, the program performed quickly. It 
does not require Multi-Vue and is consid- 
ered a faster replacement for Tandy's GUI, 
although CCTools itself does not provide 
such a graphics environment. 

Included with the. package is a program 
designed to install CCTools on your sys- 
tem. However, the copy F received for re- 
view did not work properly. Il appears thai 
the files on the distribution disk are organ- 
ized differently than the installation pro- 
gram expects. The CCTools documenta- 
tion describes an alternative method for 
installing the system, but that approach also 
did not work. Sincel am fairly familiar with 



OS-9, 1 was able to figure out where all the 
files were supposed to go and, finally, was 
able to get CCTools running. 

When active, CCTools presents you with 
an attractive screen on which there is a 
menu bar and two large windows, each 
containing a listing of the current directory. 
You can use various key combinations to 
move through the directory trees easily and 
quickly. Several functions are provided on 
the menu bar that allow you to modify the 
screen view or file structure display. Other 
key combinations allow you to start pro- 
grams, view tile contents, copy files, etc. 

CCTools offers the OS-9 user a tremen- 
dous amount of versatility. Most features 
can be customized to your preferences. You 
can select various programs that can be 
started from within the menu structure of 
CCTools, and you can even modify the way 
programs are used by CCTools to carry out 
file manipulations such as text editing and 
directory sorting. On the negative side, 
support for many of CCTools' functions is 
not built-in — you must supply external 
programs and other utilities to lake advan- 
tage of them. 

Among other things, the Analyze func- 
tion provided with CCTools is supposed to 
rename directories so they follow the OS-9 
standard and appear in all uppercase char- 
acters. However, it also renames ail other 
files with lowercase characters and exhibits 
problems in distinguishing directories from 
other file types. This function indiscrimi- 
nately renamed 90 percent of the files on 
my hard disk. Worse yet, once I started the 
function. I discovered there is no way to 
stop it. 



The CCTools documentation is included 
in the form of a file on one of the two 
distribution disks. Since this file is a stan- 
dard text file, you can print it using just 
about any printer. On the other hand, as 
with other packages using this distribution 
approach, the documentation file is hard 
coded for 66-line pages. This presented 
some problem when I printed the file on a 
standard HP LaserJet, which supports only 
60 lines per page. 

The documentation is disorganized and 
does not clearly describe how to use the 
program. Several functions were described 
in different places in the manual, and these 
different references contradicted each other. 
Some functions, especially those requiring 
external programs, were given a brief 
mention only. For example, the only men- 
tion of the Clean function is that it "cleans 
directory entries." After my experience with 
Analyze, I didn't even try it. 

It would have been nice were I able to 
contact someone from the Micro-80 Users 
Group for support in a timely fashion. 
Unfortunately, support for CCTools is 
available only through the mail. And it's a 
long way to Canada. 

C.CTools could, with some careful re- 
working, become a very useful tool for 
users of OS-9 Level II. However, without 
better documentation and provision for a 
safe way to back out of functions that have 
a global influence on disk structure, I can- 
not recommend the system. (Mkro-80 Users 
Group. 598 Riverton Avenue, Winnipeg, 
MB R2L OP I, Canada; $15, $18 Cdn., 
money orders only.) 

— Bill Budenholzer 




Most CoCo users know that magnetism is 
what allows us to store large amounts of data on 
tape and disk. Many users also know, having 
found out the hard way, that the same phenome- 
non can also destroy that data in the wink of an 
eye. Magnetism giveth, and magnetism taketh 
away. Following are a few dos (and implied 
don' is) for protecting data when you are storing 
tapes and disks: 

— do keep tapes and disks at least six inches 
away from video monitors and televisions. Other 
devices to watch out for are tape recorders and 
audio speakers; just about any electromechani- 
cal device is capable of causing problems. 

— do store tapes and disks well above the floor. 
One fellow kept his disk box on the floor and 
lost most of his software when his spouse came 
through with a vacuum cleaner — the motor in 
the powered head erased his disks. 

— do keep tapes and disks far from "refrigera- 
tor" magnets. We know of one user who stored 
his daily backup by sticking it to the side of a 
filing cabinet with such a device from a pizza- 
delivery service. He couldn't understand why 
his data disk never worked. He has since out- 
lawed refrigerator magnets in his home. 
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Feature Program 




groups. No doubt you will find many other 
uses for this program. 



The CoCo 
Phone Book 

evor Boehm 



Trevor Boehm is a tenth-grade student 
whose greatest passion is challenging 
computers with new programs. He has 
participated in several science fairs and 
has received numerous awards for his work. 
He can be contacted at 77 Inwood Cres., 
Winnipeg, MB R2Y 1A2, Canada. Please 
include an SASE when requesting a reply. 




When you first start CoCo Fone, my 
name, address and phone number are dis- 
played. Also displayed is a menu of op- 
tions. To select an option, just press its 
starting letter. For example, to remove my 

Srsonal information, press D to select the 
;lete option. At this point, use the Add 
function to enter the appropriate informa- 
tion for your relatives, friends or business 
acquaintances. 

When you finish entering the names and 
numbers, put a freshly formatted disk in 
Drive and select Save. The file is written 
to disk under the name PH0NE#S . PHN. Once 
the file is saved, you can load it for later use 



oCo Fone is a short program 
that keeps track of phone numbers, 
names and addresses. It requires a 
CoCo with at least 32K and Ex- 
tended BASIC, and a disk drive. 

with the Load option. 

As I mentioned earlier, pressing D to 
delete a record causes the entry currently 
being displayed to be blanked, effectively 
removing it from the list. Looking up a 
number is easy as well, requiring only that 
you enter a portion (or all) of the name of 
the person you want to find. To get a printed 
copy of the record currently displayed, press 
H to select the Hardcopy option. Finally, 
use the P (Previous) and N (Next) keys to 
step backward and forward through the 
entries. 

I originally wrote CoCo Fone to keep 
track of fellow members of CoCo users 



32K Disk 



The Listing: COCOFONE 

1 "COCOFONE 

2 'BY TREVOR BOEHM 

3 "COPYRIGHT (C) 1992 

4 "BY FALSOFT. INC. 

5 'RAINBOW MAGAZINE 

9 "PALETTE 13,0:PALETTE 12.63 

10 CLEAR 5000:DIM N$( 100) ,A$( 100 
).B$(100).H$(100):HN-1:N$(1)-"TR 
EVOR BOEHM" :A$(l)-""77 INWOOD CRE 
SC.-:H$(l)-"(204) 832-4495" :B$(1 
)-"N/A":C-l:CC-l 

20 CLS:PRINT:PR1NTIAB(8)"C0C0 PH 
ONE B00K":PRINTTAB(8)" — 

30 PRINT:PRINT" NAME: ":N$(C) 

40 PRINT" ADDRESS: ":A$(C) 

50 PRINT" BUSINESS NUMBER: ":B$ 

(C) 

60 PRINT" HOME NUMBER: ";H$(C) 

70 PRINT: PRINT: PRINT-MENU :":PRIN 

T:PRINT"<A>DD <D>ELETE <OHANGE 

<S>AVE":PRINT"<L>OAD <F>IND <N>E 

XT <P>REV":PRINT"<H>ARDCOPY <0>U 

IT" 

80 A$-INKEY$:1F A$-"" THEN 80 

90 IF A$="P" THEN C-C-l: IF C-0 T 



HEN C-1:G0T0 20 ELSE GOTO 20 
100 IF A$-"N" THEN C-C+1:IF OCC 

THEN C-CC:G0T0 20 ELSE GOTO 20 
110 IF A$-"Q" THEN CLS:PRINT"TYP 
E GOTO 20 TO RESUME": END 
120 IF A$-"A" THEN CC-CC+1 :C=C+1 
:CLS:LINEINPUT"NAME: ":N$(C):LIN 
EINPUT"ADDRESS: " ;A$(C) : LINEINPU 
T'BUSINESS NUMBER: " ;B$(C) : LINEI 
NPUT"H0ME NUMBER: " ;H$(C) :G0T0 2 


130 IF A$-"C" THEN CLS:LTNFINPUT 
"NAME: ";N$(C):LINEINPUT"ADDRESS 
: ";A$(C):LINEINPUT"BUSINESS NUM 
BER: ":B$(C):LINEINPUT"HOME NUMB 
ER: ";Ht(C):G0T0 20 
140 IF A$-"S" THEN CLS:PRINT"REA 
DY DISK...":EXEC44539:0PEN"0",1. 
"PH0NE#S/PHN":F0R X-l T0CC:PRINT 
#1.N$(X):PRINT#1.A$(X):PRINT#1,B 
$(X):PRINT#1,H$(X):NEXT:CL0SE:PR 
INT-SAVED... ":EXEC44539:GOTO20 
150 IF AJ-""L" THEN CLS:PRINT"REA 
DY DISK...":EXEC44539:0PEN"I",1, 
"PH0NE#S/PHN":F0R X-l TO CC:LINE 
INPUT#l,N»(X):LINEINPUT/n.A$(X): 
LINEI NPUT#1.B$(X):LINEINPUT#1,H$ 
( X ): NEXT : CLOSE : PRINT" LOADED . . . " : 
EXEC44539:GOTO20 

160 IF A$-"F" THEN CLS-.LINEINPUT 
"NAME: ";F$:F0R X-l TO CC:IF INS 
TR{N$(X).F$)<>0 THEN C-X:G0T0 20 

ELSE NEXT:PRINT"NOT FOUND... ":E 
XEC 44539 :GOTO20 

170 IF A$-"D" THEN N$(C)-"" :A$(C 
)-"": B$(C)="":H$(C)="":GOTO20 
180 IF A$-"H" THEN CLS:PRINT"REA 
DY PRINTER.. .": EXEC44539 : PRINT#- 
2, "NAME: " ;N$(C) : PRINT//-2, "ADDRE 
SS: ":A$(C):PRINT#-2, "BUSINESS N 
UMBER: ";B$(C) : PRINT#-2. "HOME NU 
MBER: ";HJ(C):GOTO20 
190 GOTO 80 



I ordered a complete system consisting 
of the circuit boards, 3 megabytes of 
memory, an XT-compatible keyboard, a 3'/$- 
inch high-density floppy drive, and a case 
and power supply. I received everything 
but the I/O board. This board is on back 
order, and I hope to receive it soon; the 
SCSI hard-drive host adapter is on the I/O 
board, and 1 cannot yet use a hard drive with 
the system. To offset this, I added a second 
3'/4-inch high-density drive. [Editor's Note: 
Mr. Donaldson wrote this article prior to 
receiving the I/O hoard for his MM 1 1. While 
the article was in production at THE RAIN- 
BOW, however, he received the board and 
sent us an update. We decided to publish the 
update separately. It will appear with Part 

2 of this article in the December 1992 
issue.] 

So far 1 have been very pleased with the 
MM/1 , and the software that comes with it 
is impressive. Included are Microware's C 
compiler and Microware Basic. The latter 
is the same as BASIC09 for the CoCo except 
there is no graphics library (gf x or gf x2) at 
the present time. A cf gx . 1 graphics library 
is included for the C compiler. This graph- 
ics library is nearly identical to the version 
of cgf x . 1 that comes with the OS-9 Level 
n Development System. The main differ- 
ences are features that allow you to use the 
more powerful features of the 68070 CPU 
and the VSC graphics coprocessor. 

Using the MM/1 as a floppy-based sys- 
tem reminded me of the days on my CoCo 

3 before I got a hard drive. The first thing I 
did was create three system disks: one for C 
programming, one for basic programming, 
andone for telecommunications. 

When 1 tried to run a program on my 
MM/1 for the first time, I received an error 
telling me that OS-9 could not find /TERM. 
I soon discovered that the OS-9/68000 uses 
a file called TERMCAP that tells it what kind 
of terminal you are using. The terminal 
identifier for the MM/1 is called VSC. So I 
used OSK's environment variables to set 
the terminal type as follows: 

setenv TERM vsc 

Once OSK knew my terminal parameters, 
programs like Sterm and MicroEmacs ran 
fine. 

The purpose of the TERMCAP approach is 
to allow software to be used with many 
different terminals. For those who use OS- 
9 on the CoCo, Dynacalc, Scred and Dy- 
naStar use a similar file. Since OS-9 is a 
multiuser operating system, TERMCAP makes 



it easy to have different types of terminals 
connected to different serial ports. Differ- 
ent terminals have different parameters for 
handling functions such as the number of 
display lines, function-key definitions, 
cursor controls, etc. TERMCAP redefines these 
functions so that different terminals look 
the same to the operating system. 

I soon got tired of entering my terminal 
setting when I booted the system, so I 
looked for a better way to handle that task. 
From the OS-9 manuals, I learned that OS- 
9/68000 supports two unique files named 
. LOG I N and . LOGOUT. (Notice that there is a 

S:riod in front of these filenames; this tells 
SK that the file is invisible — the names 
won't show up in a standard directory list- 
ing. Appendi ng a period to the beginning of 
any file or directory name hides it from 
view.) The entries in these two files affect 
the user's environment. I added the follow- 
ing environment settings to my . I OGTN file: 

setenv TERM vsc 

setenv MODEM /tO 

setenv PROMPT MM/1: 

xmode /tO baud-1200 t.ype-0 

Now OS-9 knows what my terminal type is, 
which serial port 1 want to use for my 
modem, what I want the prompt to look like 
(instead of OSK's default dollar sign), and 
the serial-port settings I want. 

The . LOGOUT file works the same way 
except that its contents are executed when 
you enter 1 ogout. This is useful in multi 
user setups and for simply returning Ihe 
environment to its default status. 1 ogout is 
also used lo terminate a window or shell, 
much like the ex command in OS-9 Level 
II. If you try to enter ex in an OS-9/68000 
shell, you'll receive an error message tell- 
ing you that you can't log out that way. 

Let's go back to the hidden files for a 
minute. If a file is invisible, how can you 
tell if it's stored in a directory? OSK's di r 
command provides many more features than 
Level II d i r command. To see hidden files, 
you enter the - a option on the command 
line. Another option is - u, which tells di r 
not to format the listing. OSK also supports 
wildcards. 

These features allow you to enter such 
fancy command lines as 

dir -u *.c ! attr -z 

The - u tells d i r to display each directory 
entry on a separate line, and * . c tells it to 
list only those entries that end with a . c. 
Then the output of the dir command is 
piped through a t L r so the attributes for die 



specified files are also listed. 

With OS-9 on the CoCo 3, 1 used cob 
bl er instead of 0S9Gen to create new boot 
disks because it was much easier, cobbl er 
is not included with OS-9/68000. Instead, 
Microware made the 0S9Gen utility very 
easy to use. Interactive Media Systems 
includes several script files for creating 
boot disks. Since I haven't received the I/O 
board, all T had to do was alter a script file 
so that it didn't add the sound and mouse 
drivers to the new boot file. After this, 
making a boot disk was easy — I simply 
entered boot.lmfd, and the script file as- 
sembled the modules and built a boot file on 
the disk in Drive /dl. 

Another easy way to create boot disks is 
to copy the boot file from / d to / d 1 . Then 
just enter 

os9gen /dl -eq-/dl/os9boot 

The options -eq are used when linking to 
LSNO. The - e option tells the system to use 
an extended boot size (larger than 64K), 
and -q stands for "quick hoot." It links 
LSNO lo point to the starting address of the 
boot file. The boot ROMs will then load the 
system from the OS9Boot file. Since OS9Boot 
is not limited to 64K, I like to make a master 
disk and just use this method to make boot 
disks. Another handy thing to know is that, 
unlike 0S9Boot with Level II, the boot file 
doesn't have to fit into a continuous space. 
Updated modules and drivers for the 
MM/1 and OSK have been posted on Del- 
phi and CompuServe in the OS-9 SIGs. I 
recommend you check these updates and, if 
they are newer than what you received with 
your system, download the archive. After I 
stored the unarchived modules on my 
Bootmods disk, I created a new boot file. 
The first thing I noticed when booting after 
that is the boot file loads and executes much 

r'eker. Disk access is also somewhat faster. 
other feature is that the console bell now 
beeps (it seems there was a bug in the early 
wi ndi o driver). 

When setting up a startup file for OSK, 
make sure the first line is something like 

iniz /d0 /dl /rO /tO /tl /p 

When booting a floppy-based system, it 
isn't necessary that you mitalize the drivers 
using iniz. However, it is required for 
hard-drive systems, and it makes good sense 
to go ahead and do it on floppy systems. 
This way they are at the top of memory and 
their buffers have already been initialized. 
It also keeps the system from fragmenting 
memory. I always did the same thing in my 



startup file on the CoCo 3. There, if you 
didn't initialize the floppy-disk drivers, the 
drive would sometimes stay on after the 
system switched to the hard drive. 

Next month I'll discuss some other fea- 
tures OSK offers and share my initial expe- 
riences with the OS-9/68000 C compiler. 



John Donaldson is a software engineer 
in the gas-turbine division of Stewart & 
Stevenson Services. In addition to working 
with computers, his hobbies include ama- 
teur radio, model railroading and sailing. 
His Delphi username is vaxelf. 
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EDDIE KUNS 



Using the Forums 

Last month I introduced basic informa- 
tion about Delphi Forums. This month, 
let's build on that foundation. 

So what is a thread? Basically, all replies 
to a given message, and replies to these 
replies, constitute a thread. A thread is a 
continuing discussion. You can tell a mes- 
sage is part of a thread if, after reading the 
messase,youseethemessageEnter FO L - 
LOW for related Message(s).If 
you type FOLLOW at the F0RUM> prompt, 
you are shown the next message in the 
thread. You need only press ENTER after 
each message to see the following message 
in the thread; between messages you will 
see Press RETURN for related 
Message(s). When you have read all of 
the following messages in the thread, you 
see the message End of Thread. 
Press RETURN to resume. At this 
point, pressing ENTER brings you to the 
first available message following the mes- 
sage where you typed FOLLOW. 

The reverse of the FOLLOW command is 
BACK. If you enter BACK, you see the 
thread in reverse. First you see the message 
the current message is in reply to. The next 
time you press ENTER you see the message 
which that message was in reply to, etc. 
You won't necessarily see every message 
in a thread when you use this command. 



The Forum software keeps track of all 
messages you have read, but only until you 
leave Forum. Thus, if you follow a thread 
and then exit Forum, you may set your 
high-message counter higher than you want. 
The high-message counter is set to the 
highest message number you read, even 
though you have not read all intervening 
Forum articles. If you don't want to skip 
messages like this, you can use the HIGH 
command to set your high-message counter 
to make sure that you don't lose any mes- 
sages. Here is an example: 

F0RUM> high 

Last Message in Forum: 63287 
High Message on Entry: 62806 
Current High Message : 63215 
New Value (or RETURN): 

I can type the number I want my high- 
message counter set to, or I can just press 
ENTER to keep my current setting. 

If you enter READ NEW right before ex- 
iting Forum, you are presented with the 
lowest numbered new message you haven't 
read in this Forum session. A new message, 
of course, is a message higher numbered 
than your high-message counter when you 
entered Forum. Thus, if you READ NEW 
and then set your high-message counter to 
the message number of that message, you 
won't miss any Forum messages. 

Now that you know what a thread is, 
how do you add your own thoughts to a 
thread? If you have just read the message to 
which you want to reply, simply enter RE - 
PLY. You can also type REPLY article- 
number, where article-number is the num- 
ber of the Forum message you want to reply 
to. Either of these commands drop you into 
Delphi's simple line editor. Enter your reply 
and press CTRL-Z or / E X I T when you are 
finished. You can also enter /EDIT to 
enter your chosen online editor, / L I ST to 
list the lines you have entered so far, and / 
D E L to delete the last line of your article. 



If you have uploaded a response into 
your workspace — thus doing the editing 
offline and saving yourself some money — 
enter REPLY article-number filename to 
enter your reply. Don't forget to delete the 
file from your workspace when you are fin- 
ished! You can also enter REPLY MAI Lto 
send a private reply via Mail. 

If you want to start a thread — say you 
have a question you want to ask — use the 
ADD command. Simply enter ADD and an- 
swer all the prompts. You need to decide 
who the message is to (the default is A L L), 
the message topic, and the message's sub- 
ject. Be careful to make the subject mean- 
ingful. After entering ADD, use Delphi's 
simple line editor described above. 

What do you do when you see a lengthy 
thread in which you are completely uninter- 
ested? You certainly don't want to spend 
the time online reading through it. If you 
enter IGNORE THREAD, Forum remem- 
bers to not show you any articles which 
belong to the same thread as the current 
article. 

The IGNORE command is much more 
powerful than this, however. You can also 
enter IGNORE SUBJECT AUTOtoignore 
all messages with AUTO in the subject. If 
there are certain people you don't want to 
hear from, you can enter IGNORE FROM 
name where name is the Delphi username 
of the person you want to ignore. IGNORE 
settings remain in effect only until you 
leave Forum or change them. IGNORE 
NONE turns off all I G NO R E settings. 

Two more very useful commands are + 
and - . If you just finished reading Forum 
message 63035, entering +5 shows you 
message 63040. Of course if message 63040 
has been deleted, it shows a following 
message. You could also have typed - 2 to 
see Forum Message 63033 . Entering only - 
is equivalent to entering CURRENT — the 
current message is redisplayed. One nice 
thing about the - command is that it does 
not interrupt the flow of R E A D NEW; when 
you press ENTER by itself, you see the next 



new message. In contrast, if instead of - 2 
you enter 63033, pressing ENTER shows 
you message 63034 next. 

If someone has sent you a "See you next 
Tuesday" message in Forum, and you de- 
cide that it doesn't need to stay around any 
longer, you can use. the DELETE command 
to delete the Forum message. You can de- 
lete any message you have posted to Forum 
and any message posted to you. Be careful: 
once a message is deleted, no one can get it 
back. 

The appropriate final command to de- 
scribe this month is LAST. Just as in mail, 
LAST displays the highest-numbered mes- 
sage. Remember, this sets your high-mes- 
sage counter to the highest message in 
Forum! If you want to read some of the 

Grior messages, you may want to use the 
I GH command before leaving Forum (or 
the next time you enter Forum if you wrote 
down your desired high-message number). 
Next month I'll finish describing Fo- 
rum, touching on some more advanced 
commands. 

June Uploads 

In the OS-9 SIG General Information 
database, Tim Kientzle (TIMKIENTZLE) 
released a file containing MM/1 expansion 
information, including information about 
monitors, keyboards, SCSI hard disks and 
mice that are known to work with the MM/ 
1. He has also included useful hardware 
information. Cray Augsburg (CRAY) 
uploaded THE RAINBOW'S submission 
guidelines. Jim Vestal (JIMVESTAL) sub- 
mitted Allen Huffman's report on the First 
Annual Last Cocofest. Chris Burke (CO- 
COXT) explains how to install a new 6309 
CPU in your CoCo without physically 
removing your 6809 — something many 
may want to do when installing their Pow- 
erBoost, which Marty Goodman (MAR- 
TYGOODMAN) reviews. Chris Burke also 
released a patch to booster and informa- 
tion to help those who get Error 221 when 
trying to run booster — both in the 
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System Modules (6809) database. Finally, 
Alfredo T. Santos (alfradio) released a 
history of the CoCo. 

In the Telecom (6809) database, Jim 
McDowell (JMLSOFT) released AutoQuesi 
— a program useful when playing Delphi's 
Quest for the Holy Grail found in the Enter- 
tainment section. The program uses a split 
screen and is a front-end to Delphi's game. 
Hugo Bueno (MRGOOD) uploaded Vir- 
ginia's UUCP map for someone who wanted 
to find a UUCP connection. Files like this 
appear from time to time in the databases 
but don't necessarily remain for years, as 
the information in them changes rapidly. 

Joel Hegberg (JOELHEGBERG) released 
a couple of useful utilities into the OSK 
Applications database — both run under K- 
Windows on the MM/1 . WSee allows you to 
look at the contents of another window 
while SnapShoi allows you to save the 
contents of another window to disk and 
view it later. Leonard Cassady (maudib) 
uploaded a patch that customizes Uqvt70 
for DynaStar on the TC-70. 

Mark W. Farrell (XLIONX) wrote a 
quite extensive review of methods of ap- 
plying patches. This is a companion to his 
prior upload NewLev2.ar, listing a great 
many known patches and enhancements to 
OS-9 Level 2 and applications. If you have 
been afraid to apply patches, fearing it 
would be too difficult or too dangerous, 
read this! 

In the CoCo SIG, Allen Huffman (SUBE- 
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GRAPHICAL CLOCK FOR MM/1 
JOELHEGBERG Joel Hegberg 

SH DOCUMENTATION 
THEFERRET Philip Brown 



THA) released a report of the First Annual 
Last CoCoFest at Chicago. Cray Augsburg 
(CRAY) released THE rainbow's submis- 
sion guidelines. These two groups are the 
same as those in the OS-9 SIG. Also dupli- 
cated is Alfredo Santos' (ALFRADIO) his- 
tory of the Color Computer. 

In Utilities & Applications, Joe San- 
nucci (SANNUCCI) uploaded the final ver- 
sion of Japan! 23 by Larry Greenfield. This 
program allows you to edit Japanese text, 
and print it to a dot-matrix printer. F.rich 
Schulman (eschulman) released a pro- 
gram which allows viewing . MAX files on an 
IBM PC-type computer. John Saya's 
(SAYA) Switch program converts an ASCII 
data tile into a BASIC file you can load and 
run. When you run the switched file, you 
see the original text file! 

Marty Goodman (MARTYGOODMAN) 
reviews the Burke & Burke PowerBoost in 
the Product Reviews & Announcements 
database. Alvin Cotton (ACOTTON) released 
the StarLink BBS in the Telecommunica- 
tions database. 



Eddie Kuns is pursuing a doctorate in 
physics at Rutgers University. He lives in 
Aurora, Illinois, and works as a program- 
mer and researcher at Fermilab. Eddie is 
the database manager of the OS-9 SIG and 
can be reached online as EDD1EKUNS. 



UQVT70 MODIFIED FOR DYNASTAR 
MAUDIB Leonard Cassady 

OSK Telecom 

PHILMA1L: UUCP OFFLINE MAIL READ 
THEFERRET Philip Brown 

Tutorials & Education 

HOW TO SAFELY DO PATCHES 
XLIONX Mark W. Farrell 



Product Review 



COCO SIC 



General Information 

COCONUTS OF AMERICA CLUB 

BFLAHIVE Brian Flahive 

LAST FEST '92 REPORT 
SUBETHA Allen Huffman 

RAINBOW SUBMISSION GUIDELINES 
CRAY Cray Augsburg 

ARCHIVED COCO CHRONICLES 
MARTYGOODMAN Marty Goodman 

THE "COCO" CHRONICLES 
ALFRADIO Alfredo T. Santos 

CoCo 3 Graphics 

COLOR DFM0 

BFLAHIVE Brian Flahive 

BEATLES IN CM3 

DEANHOLDER Dean Holder 

STAR TREK:TNG RASCAN IMAGES 

DEANHOLDER Dean Holder 

BOUNCIN - BALL 

SANNLCCl Joe Sannucci 



Utilities & Applications 

JAPANESE-WRITER PROGRAM 

SANNUCCI Joe Sannucci 

VIEW .MAX IMAGES ON A PC 

ESCHULMAN Erich Schulman 

SWITCH - UPDATED 

SAYA John Saya 

SWITCH 

SAYA John Saya 

Games 

COOKIE MONSTER TO DISK 
MARTYGOODMAN Marty Goodman 

Product Reviews & Announcement 

INFO ON POWER BOOST 
MARTYGOODMAN Marty Goodman 

Telecommunications 

STARLINK BBS 

ACOTTON Alvin Cotton 



Graf Express 2.0: 

On the Road to 

Multimedia 



Multimedia on a CoCo? That's a pretty 
tall order for an 8-bit computer — even a 
machine as powerful as my beloved CoCo 
3. So it was with some skepticism that Iread 
Sundog Systems' advertisement for Graf- 
Express 2.0. When I received the product 
for review, I got a chance to see if that 
skepticism was warranted. 

GrafExpress is a library of software 
routines that allows you to create your own 
high-speed, high-resolution graphics pro- 
grams. It also includes support for four- 
voice sound. This library gives you the 
tools you need to write, say, the next great 
arcade game or perhaps a user-friendly 
application complete with a fantastic GUI. 
GrafExpress doesn't add commands to BA- 
SIC but works with it. You can write pro- 
grams in BASIC or assembly language (an 
assembler is not included), or a combina- 
tion of the two. 

GrafExpress requires a CoCo 3 and a 
disk drive. Although the package works 
fine with 128K, you'll find 5 12K adds to it 
a great deal of flexibility. 

Graphic images can be generated through 
lypical drawing commands such as box, 
line, rectangle, circle, color, set and fill. 
These commands can address locations that 



extend beyond the viewing area, and that 
portion of the drawing that is visible will be 
displayed correctly through the window. 
The graphics area may be scrolled to reveal 
different parts of the drawing. Graphics can 
also be loaded from disk and displayed. 

GrafExpress gives the CoCo 3 program- 
mer the ability to use sprites — "magical" 
little graphics elements that can be moved 
around the screen, passing under or over 
other images. Sprites can be generated us- 
ing drawing commands or loaded from 
disk, and two types are supported: "sticky" 
sprites leave a copy of themselves when 
they are moved, while "nonsticky" sprites 
move around the screen without changing 
the background. Sprites are assigned a 
numerical value for identification, and 
functions are included that tell the system if 
a sprite comes in contact with another sprite 
or range of sprites. Stationary sprites can be 
used to define boundaries for a moving 
object — by checking for a collision, the 
program knows if the sprite has moved into 
the boundary. Collisions between moving 
sprites can also be tested. 

GrafExpress allows you to create and 
manage windows. These windows can cover 
the entire screen or occupy only a portion of 
it. They may overlap, but GrafExpress does 
not save the image under a window. You 
must preserve the image yourself if you'll 
need to restore it later. Alternatively you 
can rewrite the entire window after the 
covering window is closed. Each window 
can function independently of other win- 
dows and may contain completely different 
images or information. Windows can also 
work as a virtual viewport into a complete 
image, allowing various parts of the image 
to be seen. 
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Text can be displayed onscreen in a 
variety of ways. Font width and height are 
easily altered, and characters can be dis- 
played with a solid background color or 
may be transparent, allowing the back- 
ground to show through. Scrolling text on a 
graphics screen is also easy to accomplish. 

GrafExpress' music commands provide 
programmers with the ability to work with 
up to four voices at one time. A sound's 
envelope (the way the sound starts, sus- 
tains, and dies away) and timbre (e.g., brass, 
flute or any imaginable quality) can be 
controlled. Although pitch is specified 
through a non-musical system of numbers, 
the system provides the ability to generate 
a greater variety of sounds; and the docu- 
mentation includes suggestions for creat- 
ing special sound effects. A table for con- 
verting the numerical values to musical 
notes is also included. Other sound com- 
mands allow you to change the tempo and 
duration of a sound. 

Finally, GrafExpress has commands that 
provide joystick support for systems with 
and without the Tandy Hi -Res adapter. The 
clock speed of the CoCo 3 can also be 
controlled using a simple command. 

Programs written in BASIC call Graf- 
Express by first setting up a string variable 
that includes the commands to be passed 
then executing GrafExpress. The program 
works with integer variables so that nu- 
merical values can be updated as it runs. 
This may cause some difficulty since BASIC 
on the CoCo is always in the floating-point 
mode. But if you remember that you must 
remove any part of a number to the right of 
the decimal point (using FIX or INT), you 
shouldrft have any trouble. Several ex- 
amples of how to write programs using 



GrafExpress are included on the distribu- 
tion disk, and the documentation clearly 
explains each function of GrafExpress. 
When writing basic programs for use with 
the system, you will find that the command 
syntax for GrafExpresi is very similar to 
that supported by Disk BASIC. 

Machine-language programs call the 
GrafExpress routines directly by setting up 
the necessary registers and executing a JSR 
to GrafExpress. Sundog Systems has in- 
cluded files that make getting started easy. 
By including the assembly-language files 
in your own programs and initializing Graf- 
Express, your machine-language creations 
can benefit from the graphics and sound 
routines available with GrafExpress. The 
examples included on the GrafExpress disk 
are well-commented and make it easy to 
write your own programs. 

The documentation for GrafExpress is 
in the form of a typeset 48-page booklet. Its 
four sections cover various aspects of the 
system and include detailed explanations of 
all of the instructions. The first section 
explains in general terms the function of the 
system and how the remainder of the book- 
let is organized. This section also explains 
some of the philosophy behind the develop- 
ment of GrafExpress. This information is 
helpful when writing programs since it helps 
you understand how the instructions inter- 
act with your computer. 

The second (and largest) section gives 
detailed explanations of each GrafExpress 
function. The information is organized 
logically according to the type of function. 
Specific examples regarding the general 
use of each instruction are included, as are 
tips for more efficient use of the instruction. 

Section 3 is intended for those who want 



to use GrafExpress with assembly language. 
It explains how to include the source-code 
files on the disk, making the use of Graf- 
Express functions in your programs much 
easier. 

The fourth section covers the use of the 
system's auxiliary programs. The Graf- 
Express distribution disk includes several 
auxiliary programs that help you create 
your own programs. Pic-Maker provides 
an easy way to build sprites in any of the 
supported resolutions. Wave-Maker is a 
neat application you can use to generate 
sound waves for use with the sound func- 
tions. I was able to create sound waves and 
envelopes with Wave-Maker and was im- 
pressed with its appearance and function. 
Onscreen buttons make it easy to test sounds 
under different conditions. ArtExpress is a 
simple graphics editor that allows you to 
create pictures in the 256-color mode (256 
colors are available only with a color com- 
posite video monitor or a color television). 
All of these applications were written using 
GrafExpress functions. Probably the best 
part about these applications is the fact that 
the source code is included on the disk. This 
allows you to take a look at how programs 
are written for GrafExpress. Other utilities 
allow you to import portions of any 
H S C RE E N 2 graphics screen and CoCo 3 fonts 
for use with GrafExpress. 

Although there is no index in the man- 
ual, the table of contents includes enough 
entries that readers are quickly guided to 
the desired information. A single errata 
sheet explained the use of some of the 
newer utilities and also gave information 
on how to patch GrafExpress for use with 
ADOS. 

If you write an application that relies on 



GrafExpress routines, you can legally dis- 
tribute only those portions of the program 
that you have written. If another person 
wants to run your application, he must have 
his own copy of GrafExpress for the pro- 
gram to work. Alternatively, Sundog Sys- 
tems offers licensing agreements under 
which you may distribute your application 
along with those parts of GrafExpress 
needed to make your program functional. 

In my time with the product, everything 
appeared to function as it should. As ex- 
pected, the assembly-language programs 
performed faster than the basic programs, 
but even the BASIC programs ran with in- 
credible speed. There is certainly nothing 
wrong with that. The only "fault" I noticed 
was that the cursor kept jumping to the right 
side of the screen when I used the Hi-Res 
joystick adapter. This may need a little 
tweaking on the part of Sundog Systems. 
Although the system works with 128K, 
you'll be able to use more sprites, windows 
and screens — as well as longer music — if 
you have 512K in your CoCo 3. In other 
words, at least in this case, more is better. 

The documentation was far better than 
much of the documentation I've seen, and 
the supporting programs and programming 
examples make it easy for the average 
programmer to write his own applications. 
And more-experienced programmers 
should be able to write some really fantastic 
games and business and graphics applica- 
tions using GrafExpress. (Sundog Systems. 
21 Edinburg Drive, Pittsburgh, PA 15235, 
412-372-5674; $34.95 plus $2.50 SIH). 



— Bill Budenholzer 




The critics will be raving abo u t th is strategy game! Based on an original concept by au thor JeffSteidel, 
Photon is an addictive time-muncher in the spirit of Lemmings"' and Terris™. Match wits with 
Ludevide,lheevilpowerdroid, as you reasonyourway through over 60 devious levels. Thenumerous 
original music scores, digitized speech and sound effects, and pleasinganimation and graphicsenrich 
Photon to make it an unparalleled gaming experience. Soon to be released on a variety of computer 
platforms, the CoCo Community is lucky enough to be given first glance at this fantastic game! Req. 
1 28k CoCo-3, disk drive, and joystick. 

$34.95 



50% OFF! 

SundogSystems a Wowtngo«tselecledback-stocksoftware,and you can now take ad vantageof these 
bargains to completeyour Sundog co Uection! Fora limited time, you can buysomeofthebest CoCo 
games at 50% off retail price!! Half off factory-new game software. . .you'll never find a better deal! 

Paladin's Legacy reg. $24.95 now $12,451 

Hall of the King 1 , 2, or 3 reg. S29.95 now $ 14.95! 

Kung-FuDude reg. $24.95 now $12.45! 

White Fire of Eternity reg. $19.95 now $9.95! 

Dragon Blade reg. $19.95 now $9.95! 

Champion reg. $19.95 now $9.95! 




cirjpoa 



PO Box 766 Manassas, VA 221 11 
(703) 330-8989 

Visa. MC, chaJt MO. and COD (US only. please) accepted All foreign 
ordersmust besemin US currency MO'i Include S2 .50 for ahippingin USA 
& Canada. IS foreign. S3 ottra for COD orders. PA residents add 6%ux. 






WHAT THEY'RE SAYING ABOUT 
COCO FRIENDS DISK MAGAZINE 



■r-s'-codbrea 
-•« impressed ' 
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interesting to«nd out „ 
1 about other CoCo users 
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Boing 



...Last night I sat down at my 
CoCo and read Issue #2 from 
'cover to cover," and realized 
what a terrific idea the CDFM 
really is, and much too good to 
pass up. So, I am enclosing a 
money order.. .to cover 
issues *2-#7. 
\-Gordon C. Matthews, Canada 
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1 ISSUE $6 -3 FOR $16 
OR 6 FOR $30 
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RICK'S 



(606) 787-5783 
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ENTERPRISE 



P.O. BOX 276 
LIBERTY. KT. 42539 
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CELSIUS FROM COVER 

other. As written, the program works on the 
CoCo 3, though it should be fairly easy to 
modify for use with a CoCo 1 or 2. 

The relationships between the Fahren- 
heit and Celsius temperature scales are given 
by two simple equations (actually one equa- 
tion that can be inverted depending on the 
conversion desired). As shown in Line 210 
of CELSIUS, the equation for converting 
from Fahrenheit to Celsius is 

C = (F-32)*5 
9 

where C and F are the Celsius and Fahren- 
heit values, respectively. Rearranging terms, 
if wc know the Celsius value, wc can deter- 
mine the corrseponding Fahrenheit value 
using 



This formula appears in Line 290, though 1 
use different names for the variables in- 
volved. 

It is things like this that make using the 
CoCo so much fun. I hope your curiosity is 
similarly piqued by the little things in life. 



Roger Carlson is a quality-assurance 
consultant in the Chicago area. In addition 
to using his CoCo, he enjoys fishing, camp- 
ing and being outdoors. Roger's Delphi 
username is PERCH. 



CoCo 3 



J 



The Listing. Celsius 



1 'CELSIUS 

2 'BY ROGER 1. CARLSON (PERCH) 

3 'COPYRIGHT (C) 1992 

4 'BY FALSOFT. INC. 

5 'RAINBOW MAGAZINE 

20 REM FORMULA FOR FAHRENHEIT TO 

CELSIUS IS C-IF-32) * 5/9 
30 REM FORMULA FOR CELSIUS TO FA 
HRENHEIT IS F-C * 9/5 + 32 
40 REM IF YOU WANT TO GO HIGHER 
THAN 99,999.9 DEGREES. THEN ADO 
[#] SIGNS TO THE PRINT USIN3 COM 
MANDS. 

50 POKE&HE03E.36 
60 WIDTH40:CLS 
70 PALETTE8.255:PALETTE0.0 
80 LUCATEL2.10:PRINT"TEMPERATURE 

90 L0CATE4.12:PRINT"C0NVERT FAHR 
CNIIEIT TO CELSIUS" 
100 L0CATE6.1'I:PRINT"AND CELSIUS 
TO FAHRENHEIT" 
I'd I OCATF0.??:5RINT"PRF.SS ANY K 
E v 

120 EXEC34442:G0T0 130 

130 CLS:L0CATE18.8:PRINT"MENU" 

140 LOCATE13,10:PRINT"1) FAHRENH 

EIT" 

150 L0CATE13,12:PRI>JT"2) CELSIUS 

160 L0CATE13.14:PRI1T"3) QUIT" 

170 LOCATE0,22:PRINT"SELECT 1-3" 

180 AN$=INKEYt:IF AN$=""T4EN 180 

190 IF AN$="1"THEM230 ELSE IF AN 

$="2"THEN 270 ELSE IF AN$-"3"THE 

N 350 

200 CLS: L0CATE12.il: INPJT"FAHREN 

HEI I": F 

210 C=(--32)*5/9 

220 C-S 

230 LOCATC8.10:PRINTF"DEGREES FA 

HRENHEIT -" 

240 L0CATE7.12:PRINTUSING"#//#W/. 

#";C;: PRINT" DFfiRFFS CELSIUS" 

250 LOCATE0.22:PRINT"PRESS ANY K 

EY" 

260 EXEC34442:G0T0 130 

270 CLS 

280 LOCAU12.10:INPUT"CELS1US":C 

E 

290 CL-CE*9/5+32 

300 CLS 

310 L0CATE8, 10: PRINTCE"DE3REES C 

ELSIUS =" 

320 I 0CAT-7.1?:PRINTUS1NG"«W//H/. 

#":CL::»RINT" DEGREES FAHRENHEIT 

330 LOCATE0.22:PRINT"PRESS ANY K 

EY" 

340 EXEC34442:G0T0 130 

350 POKE&HE03E.18 

360 PALETTE RGB 

370 WIDTH32 __ 

380 END //"*\ 



Feature Program 

W hilegoingthroughmy backissuesof 
THE RAINBOW, I came across a modified 
version of the OS-9echo command, written 
by Stephen Goldberg ("KISSable OS-9," 
March 1989, Page 153). 




Echo 

((revisited)) 

by John Collyer 




This version gives you some Unix-style 
enhancements that allow certain types of 
screen control from within echo, making it 
far more useful. Since I was lucky enough 
to get a copy of OS-9 Level I, which in- 
cludes and assembler, I decided to try as- 
sembling this handy utility. 

As I entered the source code to Mr. 
Goldberg's utility, I thought it might be 
nice to have a way to repeat characters with 
the echo command. This would make cre- 
ating menus and the like much easier. 1 
added the code to do this, and the version of 
echo printed here includes this code as well 
as a little hexadecimal feature from Steve. 

The new functions are documented in 
the source code (Listing 1), and the original 
functions are outlined in the March 1989 
issue. However, I have provided a brief 
overview (see Figure 1). To generate a 
backslash in OS-9, hold CTRL and press 
the slash key. As you use the program, 
remember not to enter any numbers greater 
than 255. and make sure you put a comma 
between the parameters for the \r option. 
Also remember the echo output string holds 
only 254 characters, so keep it at or under 
that number. This shouldn't be too difficult 
since you can always enter another echo 
command line to fill in as needed. 



Those users without an OS-9 assembler 
can enter the RASIC09 procedure shown in 
Listing 2. MakeEcho.b09 generates the 
executable echo program. If you are using 
BASIC09 under Level I, however, make sure 
you change all references to /dd to another 
device (such as / dO or / hO) that is supported 
under Level I. 

If you are using OS-9 Level II, the 
standard echo is loaded as a part of she 1 1 . 
For this reason, you may want to change the 
name echo to something else. This is easy to 
do with the assembly version, but the ba- 
SIC09 version requires a couple of changes 



(though still easy to make). To change the 
name to echi with MakeEcho.h09, change 
all occurrences of echo to echi in the list- 
ing. Then change the value 239 in the second 
DATA statement to 233. 



John Collyer has been programming 
since he got his first Color Computer in 
1987. He can be contacted at 323 W. Union 
St. #6, Medina, OH 44256. Please include 
an SASE when requesting a reply. 



\n go to a now line (linefeed) 

\c terminate display without a linefeed 

Vf clear the screen (formfeed) 

\\ print a backslash 

xv.v.v print the character with an ASCII value of ### 

\$.v.v print the character with a Hex ASCII value of ## 

\rxxx,yyy print the character represented by xx'x in ASCII yyy consecutive times 

\ r $.v.r , $ vy pi i nt the character represented by Hex .i.r in ASCI 1 w consecutive times 

Figure 1: New Options for echo 



OS-9 



* 



Listing 1: Echo. asm 



ECHO - COPYRIGHT (C! 1988 by S.B.G0LD8ERG 

New Hex conversion function: 

MM - pr'nt hex ## ASCII character 

New Repetition function (C) 1991 by J. R. COLLYER 

\r#»,### or \rHtt.tltt - print ASCII, number of times 





ifpl 








use /d0/defs/os9defs 




endc 








mod 1 


en, name, prgrm+objct.reent+1. entry, dsiz 


hi count 


rmb 


1 


msb character count 


locount 


rmb 


1 


Isb character count 


dcount 


rmb 


1 


digit count 


rcount 


rmb 


1 


repetition count 


buffer 


rmb 


255 


maximum length 




rmb 


200 


stack 




rmb 


200 


parameter 


dsiz 


equ 






name 


fes 


/Echo/ 






feb 


4 


edition number 




fee 


,'<c)1988 


S.B.Goldberg/ 


******** 


****** 


********** 


*** 


* GENERATE DISPLAY 




******* 


****** 


********** 


*** 


entry 


clr 


hicount 


zero character count 




clr 


locount 






eay 


buffer ,u 


sta-t of text 




pshs 


y 


save parameter pointer 


loop 


'db 


,x+ 


get text character 




empb 


f \ 


bac<slash? 




bne 


save 


no. save character 




"db 


,x+ 


yes, get next cnaracter 




empb 


#-\ 


bac<slash? 




beq 


save 


yes, save it 




empb 


#'$ 


hex digits? 




bne 


makel ow 


no. continue 




bsr 


hextobin 


hex numbe" to binary 




bsr 


checknum 


check for hex digits 




bra 


save 


save it 


makel ow 


orb 


m 


make lowe- case 




empb 


Ifc 


print withojt carriage return 




beq 


pri nt 


yes. prinL line 




empb 


form feed (clear screen)? 




bne 


newln 


no. check for new 1 ine 




"db 


5$0c 


yes. clea- screen cnaracter 




bra 


save 


save it 


newl n 


empb 


J'n 


new line? 




bne 


repeat 


no, check for repetition 




'db 


»0a 


yes. line feed 




bra 


save 


save it 


repeat 


empb 


#'r 


repetition needed; 




INTERCOM 



Pen 

oars 



./& I have a 1 28K CoCo 3 with an FD-502 disk drive, 
a DMP- 1 06 printer and a color TV. I would like lo hear 
from pen pals between the ages of 8 and 1 2. bul I will 
write to people of all ages. 

Kevin Smith 

I95H Washington 1 venue 

Portland, ME 04103 




CALIFORNIA 

•a StC, Net West, Alan Sheltra. P.O. Box 38713. 
Hollywood, 90038. (818) 761-4135. BBS (818) 761- 
4721 

COLORADO 
* ( Colorado Springs Color Computer Club. Bud Ward. 
1 1 18 Claiborne Road. Colorado Springs. 80906-5513. 
(7 19) .'92-8268 

CONNECTICUT 
i* Connecticut CoConut Connection. Charles Joseph 

CONTINUED ON PAGE 22 
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bne 


decimal 


no. must be decimal number 




■ul 


total by 16 






clr 


rcount 


zero repeat count 




addb ,S* 


add current digit 






bsr 


hexordec 


get repeat character 




leax 1.x 


bump pointer 






bsr 


checknum 


check for digit 




inc dcount 


count digit 






pshs 


b 


save it 


back2 rts 


return 






ldb 


.x+ 


next character 


*************************** 






cmpb 


#\ 


seperator? 


* CONVERT DECIMAL TO BINARY 






bne 


error 


no, exit 


****4 


******************* 


*** 






bsr 


hexordec 


yes, repeat count 


dectobin leax -1.x 


reset pointer 






pul s 


a 


output character 




clrb 


zero value 






bsr 


checknum 


digits entered? 




clr dcount 


zero digit count 




reloop 


sta 


.»■• 


save 1t 




bsr decdigit 


first digit 






inc 


locount 


count It 




bsr decdigit 


next 2 digits 






decb 




done yet? 


decdigit Ida ,x 


get digit 






bne 


reloop 


no. go again 




suba #'0 


make binary 






bra 


loop 


continue looking 




cmpa #9 


valid digit? 




hexordec 


ldb 


,x+ 


next character 




bhi back 


no. return 






cmpb 


#•$ 


hex digits? 




pshs a 


yes, save 1t 






bne 


dec 


no, dec digits 




Ida #10 


multiply old 






bsr 


hextobin 


yes, convert hex to bin 




Mil 


total by ten 






rts 




return 




addb ,s+ 


add current digit 




dec 


bsr 
ldb 

rts 


dectobin 
.y 


decimal number to bin 
get binary value 
yes. return 




adca #0 


greater than 255? 




checknum 


tst 
beq 
rts 


dcount 
loop 


digits entered? 

no, continue looking 

yes. return 










decimal 


bsr 


dectobin 


decimal to binary 


, 










ldb 


•y 


get binary value 


Listing i: MakeEcho. b09 








bsr 


checknum 


digits entered? 










save 


stb 


.y+ 


save output character 


PROCEDURE MakeEcho 








inc 


locount 


count it 


(* Generates the binary 


module Echo *) 






cmpb 


#»0d 


end of parameter? 


(* Level I - change all 


/dd to 7d0 *) 






bne 


loop 


no. get next character 


DIM 


>ath.byt:BYTE 






print 


Idy 


hi count 


output length 


DIM 


ount: INTEGER 








puis 


x 


output address 


CREATE ffpath."/dd/cmds/Echo":WRITE 






Ida 


#1 


standard output path 


FOR 


-ount-1 TO 249 








os9 


i$writln 


print it 


READ 


byt 








bcs 


out 


exit with error 


PUT fpath.byt 






error 


clrb 




clear error flag 


NEXT 


count 






out 


OS9 


fjexit 


qui t 


CLOSE #path 














SHELL "attr /dd/cmds/Echo e pe" 




************** 




*** 


END 








* CONVERT HEX 


TO BINARY 




DATA 


135.205.0.249.0.13 


17.129.209.0.38.2.147.69.99 




******** 


****** 


********** 


»** 


OATA 


104.239.4.40.99.41 


49.57.56.56.32.83.46.66.46 




hextobin 


clrb 




zero value 


OATA 


71.111.108.100.98.101.114.103.15.0.15.1.49.68 






clr 


dcount 


zero digit count 


DATA 


52.32.230,128.193.92.38.96.230.128.193.92.39.90 






bsr 


hexdigit 


convert digit 


DATA 


193.36.38.6,141,108.141.71.32.80.202.32.193.99 




hexdigi t 


Ida 


.X 


get character 


DATA 


39,82.193.102.38.4 


198.12.32.66.193,110.38,4,198 






suba 


#•0 


make binary 


DATA 


10,32.58.193.114.38.48.15.3.141.25.141.37,52.4 






cmpa 


#9 


more than 9? 


DATA 


230.128,193.44,38.60.141,13,53.2.141,23.167.160 






bis 


digisave 


no, continue 


DATA 


12.1.90.38.249.32.179.230.128.193.36.38.3.141 






Ida 


x 


get character 


"DATA 


41, 57, 141. 7-7. 230. 164. 57. 13. 2. 39. 161. 57. 141. 67 






anda 


#$df 


convert to upper case 


DATA 


230.164.141.245.23 


.160.12,1,193.13.38.146.16 






suba 


#'0+7 


make alpha character binary 


DATA 


158.0.53.16.134.1.16.63.140.37.1.95.16.63,6.95 






cmpa 


#15 


valid digit? 


DATA 


15.2.141.0.166.132 


128.48.129.9.35.14.166.132 






bhi 


back? 


no. return 


DATA 


132.223.128.55.129 


15.34.15.129.10.37.11.52.2 






cmpa 


#10 


val id digit? 


DATA 


134.16.61.235,224.48.1,12,2.57.48.31.95.15.2.141 






bio 


back2 


no. return 


DATA 


2.141.0.166.132.128.48.129.9.34.17,52.2.134.10 




digisave 


pshs 


a 


yes. save it 


DATA 


61.235.224.137.0.38.6.231.164.48.1.12.2.57.196 






Ida 


#16 


multiply old 


DATA 


130.187 
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New from GALE FORCE 

NIT IR Q 8 9 

OS9 Level II expediter 

NirrOS9 patches OS9 Level II to utilize the added features 
of the 63 09 m icro processor. 



- Faster graphics 

- smoother multitasking 

- w arp drive I/O 



- rapid text updates 

- quicker system calls 

- HD63B09E native mode 



Upgrades to NitrOSQ version 1 will be made available free 
through Delphi, CompuServe, and other bulletin boards. 
M ail order upgrades will be handled for a small S & H fee. 
Updates will be made continually. 



NHTOS9 software only 
NltfOSO Kit 



S34.SO 
$49.50 



KWIKGEN 

Still using OS9Gen, Cobbler, or Configl 
Get a REAL bootfile editor. 



- Editing done In memo 

- Load boot from 
disk or memory 

- Edit existing boot files 

In place easily 



requires OS9 Li 
■ OS9 Level II. 



•I I, 



- 100% assembly code 

- Change order of modules 

In seconds 

- Patch modules >^v 

$24.95 U.S. *2%P 



Shipping and handling is $4.00. 
Call or write for our free catalogue. 
Please call for Canadian prices. 
Checks: Allow 4-6 weeks for delivery. 
Money orders: processed immediately for 
KWIK delivery. 



kwik; 

Fast and powerful file 


^ A P,, 

editor/zapper 


- display updating Is 
Instantaneous 


allows editing of nibbles 
or half bytes 


- dynamic sector stack 


'smart' verify command 


- work on file or stack 


configurable environment 


- 100% assembly code 


built In help - easy to use 


- searching functions 




KwikZap requires OSS Level II. 


$24.95 U.S. 



NEW! More REAL software it UNREAL prices NEW! 


Two time-tested favourites 


MSF 

MSDOS File Manager 

- acceaa MSDOSdlake under OB9 


IMS 

Informational Management 
System 


- acceaa MSF formatted disks 
under MSDOS 

- CHD to MSDOS dlak 

- moat common OSS utilities will 
work on MSF dlaka 


Learn - how to run IMS programs 

- how to write your own IMS 
programs 

- to work in the interactive 
environment 


- rename MSDOS files 

- delete M8DOS fllea 

- rem ore directories on 
MSDOS disks 

• wildcard copying (which can be 
used for normal OSS use aa welll) 


Get the powerofother 'higher end' 
database software under OS9, 
Level I and II. 

Requires 256K RAM and 
two floppy drives. 


M8F requires OSS Level II 
and SdlskS 


Don't let the price fool yon. 


$35.00 


Only $65.00 !!! 



P.O 



Send check of money order to : 

Gale Force Enterprises 

. Box 66036 Station T', Vancouver, 
B.C.. Canada, V5N 5L4 



(604) 589-1660 8AM - 5PM PST (voice) and support BBS 5PM - SAM PST 
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INTERCOM 

CONTINUED FROM PAGE 20 

Scanlon, 2 Eagle Lane. Simsbury. 06070. (203) 657- 
8373 

FLORIDA 

* The Color Computer 3 Users Group. Tom Batch- 
elder. 6042 Syrcle Ave.. Milton. 32570. (904) 623- 
4405 

GEORGIA 
D Atlanta Computer Society, Inc.. Alan R. Dages, 
4290 Bells Ferry Road Suite 10639, Kennesaw, 30144. 
(404) 469-51 1 1 voice, (404) 636-2991 modem 

IDAHO 
tt Snake River Color Computer Club. Emil Franklin. 
1750 Carmel Drive. Idaho Falls, 83403, (208) 522- 
0220 

ILLINOIS 
B Cook County Color Computer Club, Howard 
Luckey, 10 McCarthy Rd., Park Forest, 60466-2122. 
(708)747-0117 

'B Motorola MicroComputerClub, Steve Adler, 1 30 1 
East Algonquin Rd., Shaumburg, 60196, (708) 576- 
3044 

IOWA 
" Metro Area Color Computer Club, Joe Cavallaro, 
2425 Ave A. Co. Bluffs. 51501. (712) 322-2438 
** Mid Iowa & Country CoCo. Terry Simons, 1328 
48th Street, Des Moines, 5031 1, (515) 279-2576 
KENTUCKY 

* Hardin County Color Computer Club, Paul Ur- 
bahns. 2887 Republic Ave., Radcliff. 40160, (502) 
351-4757 

LOUISIANA 



W The CoCo S1G, Christopher Mayeux, 20 Gibbs 
Drive, Chalmette. 70043, (504) 277-6880 voice. (504) 
277-5135 mode, n 

MARYLAND 
» Arkade, John M. Beck. 3513 Terrace Drive #D, 
Suilland, 20746, (301) 423-8418 

MASSACHUSETTS 

« NorthEast CoCo Club, Jose Joubert, 440 North 

Ave.. Bldg.9#210. Haverhill, 01830, (508)521-0164 

MICHIGAN 

* Color Computer Owners Group, Bernard A. Pat- 
ton. 388 Emmons Blvd.. Wyandote, 48192. (313) 
283-2474 

* Greater Lansing Color Computer Users Group, E. 
Dale Knepper, P.O. Box 14114, Lansing, 48901, 
(517)626-6917 

MISSISSIPPI 
w Mississippi OS-9 User Group, Boisy G. Pitre, 
Southern Station. Box 8455. Hattiesburg. 39406-8455. 
(601)266-2807 

MISSOURI 
« CoCoNuts User Group, Clyde Lloyd, 2116 N. 
Columbia, Springfield, 65803, (417) 866-8738 
« K.C CoCo, Gay Crawford. P.O. Box 520084. Inde- 
pendence, 64052. (913) 764-9413 

NEBRASKA 
w Bruce Gerst c/o Metro Area CoCo Club, P.O. Box 
3422. Omaha, 68103 

NEW YORK 

* Erie County Color Computer Club, John A. Lom- 
bardo. 57 Chapel Ave., Cheektowaga. 14225 

NORTH CAROLINA 
« Raleigh CoCo Club, P.O. Box 10632, Raleigh. 
27605,(919)878-3865 



W The Tandy Color Computer Users of Charlotte, 
Eric Stringer, 1022 Noles Dr., Mt. Holly, 28 120 

OHIO 
** The Greater Toledo Color Computer Club, Bill 
Espen, 1319 North St., Bowling Green, 43402, (419) 
471-9444 

" Tri-County Computer Users Group, Ron Potter, 
10914 Oliver Road. Cleveland, 44111, (216) 476- 
2687 

PENNSYLVANIA 

* Cumberland Valley Users Group, Thomas Martin, 
9085 Newburg Road. Newburg. 17240. (717) 423- 
5525 

RHODE ISLAND 

* New England "CoCoNuts" Color Computer Club, 
Arthur J. Mendonca, P.O. Box 28106 North Station. 
Providence, 02908, (40 1 ) 272-5096 (Sig3) 

SOUTH CAROLINA 
w Spartanburg CoCo Club, Jesse W. Parris, 152 Bon 
Air Ave., Spartanburg, 29303, (803) 573-9881 

SOUTH DAKOTA 
"B Empire Area Color Computer Users Group of 
South Dakota, Carl Holt, P.O. Box 395, Brandon, 
57005, (605) 582-3862 

TEXAS 
« The Codis CoCo Symphony. William C. Garret- 
son. 2902 Harvard St.. Irving. 75062. (214) 570-0823 

UTAH 
•b Salt City CoCo Club, L. Todd Knudsen, 6357 S. 
Lotus Way, West Jordan, 84084, (801 ) 968-8668 
WASHINGTON 

* Bellingham OS-9 Users Group. Rodger Alexander. 
3404 Illinois Lane, Bellingham, 98226, (206) 734- 
5806 



« Port O' CoCo. Donald Zimmerman. 3046 Banner 
Rd. SE, Port Orchard, 98366-8810, (206) 871-6535 

AUSTRALIA 
w Australian National OS-9 Users Group, Gordon 
Bentzen. C/- 8 Odin Street, Sunnybank, Queensland, 
4109,(07)344-3881 

W Brisbane Southwest Colour Computer Users Group, 
Bob Dcvrics, 21 Virgo St.. Inala, Queensland, 4077, 
(07) 372-7816 

CANADA 
» Club d'Oridinateur Couleur du Quebec Inc., 8000 
Metropolitain est. Anjou. Quebec. H1K 1A1, (514) 
354-4941 

GERMANY 
w OS-9 Users Group in Europe, Burghard Kinzel, 
Leipziger Ring 22A, 5042 ERFTSTADT, +49-2235- 
41069, (OS-9/6809) 

THE NETHERLANDS 
* European OS-9 User Group, Peter Tutelaers. 
Strijperstraat 50A, 5595 GD Leendc. 
s88405777@hsepml.hse.nl, +31-4906-1971, (OSK) 

PUERTO RICO 
** Puerto Rico Color Computer Club, Luis R. Marti- 
nez, P.O. Box 2072, Guavnabo, 00657-7004. (809| 
799-8217 or (809) 728-2314 




BBS's 










Stale/City 


BBS Name 


Access Number 

(Spwd-Parity-Word Bits-Stop Bits) 


Parameters 


SysOp 


Arkansas 










Sheridan 


The Grant County BBS 


(501)942-4047 


300/1200/2400-N-8-1 


Eddie Gilmore 


California 










Hollywood 


Zog's Cavern BBS 


(213)461-7948 


300/I200/2400-N-8-1 


Alan Shcltra 


Connecticut 










Manchester 


Silk City BBS 


(203) 649-9057 


300/1 200/2400-N-8-1 


Darren Kindberg 


Watcrbury 


Applause BBS 


(203) 754-9598 


300/1 200/2400-N-8-1 


Carmen Izzi, Jr. 


Hawaii 










Ft. Shafter 


CoCo'Nuts BBS Service 


(808) 845-7054 


300/1 200/2400-N-8-1 


Tommie Taylor 


Idaho 










Idaho Falls 


Snake River Computer Club BBS 1 


(208) 523-3796 


300/1 20O-N-8-1 


Jon Gould 


Illinois 










Elmhurst 


Glenside's Cup of CoCo BBS 


(708) 428-0436 


300/1 200/2400-N-8-1 


Tony Podraza 


Lake Villa 


Glenside CoCoRama 


(708) 587-9837 


300/1200/2400-N-8-1 


Dave Barnes 


Kentucky 










Elkhom City 


Cross-N-Crown BBS 


(606) 754-9420 


300/2400-N-8-1 


Tim Mcintosh 


Michigan 










Manistee 


Crystal Palace 


(616) 723-0146 


1200/2400-N-8-1 


Nelson Howard 


Taylor 


J & L's CoCo Comer 


(313)292-4713 


300/1 200/2400-N-8-1 


Jim Snider 


Mississippi 










Hattiesburg 


The OS-9 Zone 2 


(601)266-2807 


300/1 200/24OO-N-8-1 


Boisy G. Pitre 


New York 










Erie County CoCo Club 




(716)649-1368 


300/1200/2400-N-8-1 


Wayne Mullen 


Wappingers Falls 


The Dutchess CoCo 


(914)838-1261 


300/1200/2400-N-8-1 


Chris Serino 


North Carolina 










Wilmington 


Bill's Board 


(919) 395-4366 


300/1 200/2400-N-8-1 


Bill Medcalf 


North Dakota 










Minot AFB 


The 9-Line BBS 


(701)727-6826 


300/1 200-N-8-1 


David Hensley 


Ohio 










Columbus 


Springwood BBS 


(614)228-7371 


300/1 200/2400-N-8-1 


Edward Langenback 


Pennsylvania 










Conshohocken 


Charlie's Help Line 


(215)825-3226 


300/1 200-N-8-1 or N-7-1 


Charles DiMartino 


Rhode Island 










Central Falls 


The Weather Connection II BBS 


(401)728-8709 


300/1 200/24O0-N-8-1 


Eric Chew 


Virginia 










Fall Mills 


Clem's Comer BBS ! 


(703) 322-4053 


300/1 200-N-8-1 


Richard Douglas Bailey 


Washington 










Fircrest 


OS-9 Tacoma 


(206) 566-8857 


300/1 200/2400-N-8-1 


Chris Johnson 


Wisconsin 










Marinette 


Phoenix Interstate Data Systems* 


(715)732-1036 


300/1 200/24O0/96O0-N-8- 1 


Joe Bobuika 


Canada 










Twillingate. NF, 


ColorNET BBS 


(709)884-2176 


300-N-8-1 


Jason Woodford 


Windsor, Ontario 


Color Connection 


(519)948-1879 


300/1 200-N-8-1 


Cory Richert 



Notes: 

'Snake River Computer Club BBS supports all types of computers. 

■The OS-9 Zone is up from 10 p.m. to 6 a.m. seven days a week. 

'Clem's Comer BBS is up from 6 p.m. to 1 1 p.m. seven days a week. 

4 Phoenix Interstate Data Systems has a .75/hr charge for premium services, paid in adva 
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"BEFORE YOU SELL YOUR COCO 
3 FOR 20% OF WHAT YOU PAID : 

AND BEFORE YOU BORROW 
HUNDREDS OF DOLLARS MORE 
TO BUY THAT OTHER MACHINE, 

GIVE THIS EXCITING NEW 

PRODUCT A CHANCE TO SHOW 

YOU THAT THERE'S STILL MORE 

FUN IN YOUR COCO 

THAN EVER BEFORE?" 



Let me tell you why our many Friends are having a great time! 

COCO FRIENDS DISK MAGAZINE is a monthly disk magazine produced on a flipple 
diskette. Both sides are packed with PROGRAMS, GRAPHICS, TUTORIALS, VIEWS, 
REVIEWS, QUESTIONS AND ANSWERS, AUTOBIOGRAPHIES OF OUR FRIENDS, 
ADVERTISEMENTS, and more little goodies than I have room to mention here! 

Many of our contributors to CFDM are familiar names. Keiran Kenny, George 
Quelihorst, Stuart Wyss-Gallifent. Michael Hoke, James Gibbons, H. Allen Curtis, 
Robert A. Turner, Walter Bayer, and the list goes on! AND we have found many 
other talented CoCoists among our many subscribers! There's a good chance your 
name could be added to this list, too! 

Friends from all over the USA, Canada, Australia, Mexico, Puerto Rice, England, 
and Holland have joined together to make CFDM the most exciting new product for 
the CoCo in many years. 

We invite you to give us a try. Send $6 for a single Issue, $16 for three issues, or 
$30 for 6 Issues. As you read this, issue #9 will soon be mailed to our current 
Friends. Give us a try. I guarantee you'll be most pleasantly surprised! 

SEND CASH, CHECK OR MONEY ORDER TO: 



RICK'S 



COMPUTER 
ENTERPRISE 



(606) 787-5783 
CODS Add $2.50 

P.O. BOX 276 
LIBERTY, KY. 42539 



SEE MY AD PAGE 



CoCo III Tool Kit 



Disk Commands 

Backup, Initialize, 
Directory, Verify, Compare, 
Search, Edit, Erase, Speed 
Test, Step Rate Test, Gran 
Table Analysis & Repair 



File Commands 

Arclve, Copy, Kill, Rename, 
Erase, View, Edit, Print, 
Compare, Salvage, Search, 
Verify, Test Arclve, Un- 
Arclve, Xmodem SendlRec. 



Coco Tools is a comprehensive set of disk utilities, providing the most 
complete set of functions available for the standard R.S. DOS disk system. 
Comparable in scope and functionality to that of the famous utility 
available for MS-DOS computers "PC-TOOLS"! 

Coco Tools provides fast and easy operation of standard DOS commands 
like Copy, Rename, Kill, Disk Initialize and Directory thru a consistent 
and easy to use interface. It provides easy visual selection of files, so 
multiple file operations can be carried out with very few keystrokes. 
Coco Tools is also the most Comprehensive Disk Repair program 
available, it Automatically diagnosis and repairs file allocation errors, 
locates corrupt directory information and cross linked files. It provides 
fast and easy recovery of deleted files without the drudgery normally 
associated with killed file recovery. It also does lightning fast disk I/O for 
fast Backup and Copying at speeds you thought only higher priced 
computers could perform. Coco Tools has multi-file Arciving, Un- 
Arciving and Test Arciving functions plus the ability to extract any 
selected group or individual files from a compressed file with easy visual 
file selection. And allows customizing of display colors, printer/Serial 
baud rate, Drive step rates and Directory sorting preference. Coco Tools 
requires a 128K CoCo III, 1 Disk drive and an 80 column display $49.95 



To order by VISA, MASTERCARD or COD 
Call Toll Free 1-800-383-8529 

(Monday thru Saturday, 8am to 5pm PST). 

To order by mail, send check or money order for the amount of 

the program plus $4.00 for shipping and handling to : 

Cer-Comp Ltd. 

5566 Ricochet Avenue 

Las Vegas, NV 89110 

702-452-0632 



Advertisers Index 



Burke & Burke. 23 Rainbow Subscription 

Cer-Comp 5 Rainbow on Tape/Disk 

Cer-Comp 23 Rick's Computer Enterprise 

Dayton Associates Rick's Computer Enterprise 

of W.R. Hall, Lie 17 Sundog Systems 

Delphi 7 Sundog Systems 

Gale Force 21 

Owl-Ware 9 

Rainbow Back Issues , 1 1 



We appreciate your mentioning 1HE RAINBOW when you contact these advertisers 



. 14 
,. 13 
. 19 
. 23 
BC 
, 19 





Call Kim Lewis 
Eastern Sales Director 
(502)228-4492 



Call Ira Barsky 
Western Sales Director 
(312)587-1818 



The Falsoft Building 

9509 U.S. Highway 42, P.O. Box 385, Prospect, KY 40059 

(502)228-4492 • FAX (502) 228-5121 





Bcnrl)c 6 BtUFBc 



P.O. Box 733 Maple Valley, WA 98038 

U.S. ORDER DESK: (800) 237-2409 
INT'L & TECHNICAL: (206) 432-1814 

Boost your CoCo with these fine Burke & Burke products: 

THEXDER.OS9 - NEW FOR OS9. Use your TANDY™ $29.95 

Thexder cartridge under OS9. By Alan DeKok. 

The 6309 Book - 6309 programming book by Chris Burke. $24.95 

Includes XSM assembler, disassembler, and DEBUG patches 
for OS9 Level 2. 

PowerBoost - 2 MHz enhanced HD63B09E processor wl OS9 $29.95 

kernel and I/O patches (10% ■ 50% speed improvement). Note: 
soldering required for installation. 

WORLD CLASS CHESS* - Use Cvrus Chess cartridge w/L2 OS9 $29.95 

FILE SYSTEM REPACK 1.1- Faster OS9disk defragmenter $29.95 

FILE RECOVERY SYSTEM - Helps recover files from OS9 disks. $24. 95 

R. S. B.*- Disk BASlCfor Level '2 (BASIC ROM required). $39.95 

EZGEN 1.09 - Handy & powerful OS9 boolfile editor $19.95 

WILD & MV- Use wildcards with OS9 commands; movefiles $19.95 

PERTASCII- Challenging OS9gameto make words from a list of $19.95 

random letters. Play against the computer, multi-user, or BBS. 

ZCLOCK - Continuous time /dale display on Level 2 screen $9.95 

| COCO XT - Use PC MEM or RLL hard drives with CoCo! OS9 S/W $69.95 
\ included (add $30 for COCO XT-RTC version with real-time clock; 
j add $20 for XT-ROM hard disk auto-boot ROM). 

DAGGORPATCH -Transfers TANDY™ Dungeons oj Daggorath $9.95 

i cartridge to DISK BASIC. Adds disk I/O, screen dump, repeat. 
I -^ = _^__ _ __ __ ^^^^ = ^^ = _ == _ 

| WA RESIDENTS ADD 8.2% SALES TAX. MasterCard & VISA accepted. U.S. COD'S add 
j $3.75. Min. U.S. shipping $4.00. Min. to Canada $5.00. Please allow 2 weeks for delivery. 
j Overnight or 2nd- day available for in-stock items. Software upgrades $5.00 each w/rcccipt. 
including U.S. shipping. 
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Call or write lor a free catalog of more exciting Color Computer products! 


















Energy is everything, your home world depends on it. However, 
someone or something is slowly siphoning it away. As your world's 
champion, you must climb into the experimental Power Tank to 
challenge this nemesis and his minions. Your key lies with the ability 
to teleport solid mass Use this to manipulate and explore the endless 
stronghold ot the enemy, and to exploit the free-floating DIIPFS 
(Dense Units of Photon Energy) to destroy the menacing Plasma 
Droids Be cautious, though; those DUPES can be deadly, too! 
Photon, a fantastic new arcade game tor your Coco3, contains spec- 
tacular 320x200 resolution. 16 color graphics, ultra-smooth 60 Hz 
animation, and loads of real-time music and sound effects. It will 
send your mind racing over endless possibilities, requiring quick 
decisions and reactions. Quite simply. Pholon is incredibly addictive: 
it will deliver hours of excitement. Will you become your world's 
greatest hero, or just another 
energy slave? Req. 128K CoCo 3 
and disk drive. 



GratExpress 2.0 is a complete graphics and music programming en- 
viionmenl. From Mie beginner lo the accon 
can use GrafExpress to create lightning last arcade games 
applications and utilities, and windowing mutimedia demonstra- 
tions! The GrafExpress package includes two incredible systems. 
GrafExpress 16 works on all monitor types and offers sup. 
graphic resolu ; ions(lrom 128x192 lo 320x225) GrafExpress 256 ot- 
ters 6 resoutions(lrom 128x192 to 160x225 on a composite monitor) 
in an astounding 256 colors' Ever see a CoCo do tnat before? Both 
systems include standard graphics commands (CIRCLE, FILL, etc.) 
that blow away the competition. For example, the BOX command 
peaks out at over 2 MegaPixels/second; that's 300 limes taster than 
BASIC 255 separate sprites of up to 100x100 pixels each are sup- 
ported with window clipping and high res pixel level collision check- 
ing. The 8-octave/4-voice music synthesizer has independent 
envelope, waveform, and volume controls, a 7 + KHz sampling rate, 
and much more. Other lealures include text/graphics mixing, dif- 
ferent tont sizes, fast window copying and scrolling, picture 
save/load, easy implementation from both BASIC and assembly 
language, multiple screen animation, and support for 128K/512K, 
double speed, and the high-res joystick interface The package also 
contains support programs that are worth Ihe purchase price of 
GrafExpress alone! These include an introductory demo, a picture 
editor, a waveform edilor, and an art program that supports 256 col- 
ors! GrafExpress also comes with a 50 page manual that fully ex- 
plains all of lib incrediule features. .'< you do any graphics program- 
ming or simply want to see what 
your little CoCo Is capable ol, 
GrafExpress is a musl! Req. 128K 
CoCo 3 and disk drive. 



The world is In unrest Power-hungry villains and evil warlords are 
readying their forces I falls to you to lead your people against these 
armies, and only your best strategic plans can save the day. Fight 
the good tight in any era or locale. Play a simple game ol capture Ihe 
flag armed with water balloons, or climb into the cockpit of a 100 toot 
high armored warrier. Explore the deepest dungeons, defend your 
galaxy, or create your own scenarios with this incredible war game 
construction sef/simulator. Your imagination is your only limit You 
will deploy your forces with total control over hostile terrain while you 
scroll a graphic bird's-eye window over an immense world War 
Monger has terrific 320x200 resolution. 16 color graphics and in- 
cludes a tile editor to create or edit your own Play against the com- 
puter, battle with another player, or simply watch the computer plot 
againsi itself. The enemy is everywhere. Are you ready to take on the 
challenge as the War Monger? Req. ^^V^PVfl 
128K CoCo 3 and disk drive. M' >X# 1 > 1 
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